スキル

「Skills」（スキル）は、エージェントにドメイン固有の専門知識を与える、再利用可能なファイルシステムベースのリソースです。ワークフロー、コンテキスト、ベストプラクティスを提供し、汎用エージェントを専門家に変えます。プロンプト（一回限りのタスクに対する会話レベルの指示）とは異なり、スキルはオンデマンドで読み込まれ、必要なときにのみコンテキストウィンドウに影響を与えます。

2種類のスキルを付与できます。どちらも同じように動作し、タスクに関連する場合にエージェントが自動的に呼び出します。

• Anthropic提供の事前構築済みスキル： PowerPoint、Excel、Word、PDFの処理など、一般的なドキュメントタスク（pptx、xlsx、docx、pdf）。
• カスタムスキル： 自分で作成してワークスペースにアップロードするスキル。

カスタムスキルの作成方法については、Agent Skillsおよびスキル作成のベストプラクティスを参照してください。カスタムスキルをワークスペースにアップロードするには、カスタムスキルを作成するを参照してください。



カスタムスキルを作成する

カスタムスキルは、SKILL.mdファイルとサポートファイルを含むディレクトリで、zipアーカイブまたは個別のファイルとしてワークスペースにアップロードします。スキルを作成すると、エージェントに付与する際に参照するskill_* IDが返されます。Anthropicの事前構築済みスキルはすべてのワークスペースですでに利用可能であり、この手順は不要です。事前構築済みスキルのみを使用する場合は、エージェントにスキルを付与するに進んでください。

cURLまたはCLIでSkills APIを直接呼び出す場合は、anthropic-beta: skills-2025-10-02ヘッダーを明示的に渡してください。SDKはこれを自動的に送信します。

これらの例ではオプションのdisplay_titleフィールドを省略しているため、スキルのタイトルはSKILL.mdから導出されます。明示的に渡されたdisplay_titleは、ワークスペース内のカスタムスキル間で一意である必要があります。

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

カスタムスキルの一覧表示、取得、削除、バージョン管理については、カスタムスキルの管理を参照してください。完全なリクエストおよびレスポンススキーマについては、Create Skill APIリファレンスを参照してください。スキルバンドルは、Files API経由ではなく、Skills APIに直接アップロードされます。



エージェントにスキルを付与する

エージェントの作成時にスキルを付与します。各セッションは、セッション内のすべてのエージェントを合わせて最大20個のスキルをサポートします（マルチエージェントセッションを参照）。

skills配列の各エントリは、以下のフィールドを使用します。

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-4-8
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_abc123
    version: latest
YAML



次のステップ