スキル

スキルは、エージェントにドメイン固有の専門知識を与える、再利用可能なファイルシステムベースのリソースです。ワークフロー、コンテキスト、ベストプラクティスを提供し、汎用エージェントを専門家に変えます。追加する各スキルは、セッションの「context window」（コンテキストウィンドウ）にわずかなコストを発生させ、モデルがスキルを使用するのに役立つ指示とメタデータを追加します。詳細については、Agent Skillsの概要を参照してください。

スキルは2つの方法でエージェントに届きます。エージェントのskills配列を通じて付与するか、セッションにマウントされたGitHubリポジトリから読み込むかです。付与されるスキルには2つのタイプがあります。すべてのスキルは同じように動作します。エージェントは、タスクに関連する場合に自動的にスキルを呼び出します。

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

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



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

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

Skills APIはベータヘッダーを必要としません。cURLの例では引き続きanthropic-beta: skills-2025-10-02を送信しており、CLIおよびSDKのbetaコマンドは自動的にこれを追加します。このヘッダーを含むリクエストは変更なく動作し続けます。

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

ant beta:skills create \
  --file example_skill.zip

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



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

エージェントの作成時にスキルを付与します。各セッションは最大500個のスキルをサポートし、セッション内のすべてのエージェントにわたって重複排除されたセットとしてカウントされます（マルチエージェントオーケストレーションを参照）。

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

ant beta:agents create < agent.yaml

name: Financial Analyst
model: claude-opus-5
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest



GitHubリポジトリからスキルを読み込む

スキルはコードベース内に配置することもできます。セッションがgithub_repositoryリソースを通じてリポジトリをマウントすると、セッション開始時にリポジトリのルートにある.claude/skillsディレクトリがスキャンされ、そこで見つかった各スキルがエージェントで利用可能になります。アップロードもエージェントのskills配列へのエントリも不要です。エージェントは、検出された各スキルの名前、説明、サンドボックス内のパスを確認し、タスクが一致した場合にスキルのSKILL.mdを読み取ります。これには、スキルに同梱されているスクリプトやリソースも含まれます。検出は、デフォルトで有効になっているエージェントツールセットのエージェントのreadツールに依存します。readが無効になっているエージェントは、リポジトリスキルを読み込みません。

検出は、リポジトリルートから1階層の深さで、正確に.claude/skills/<skill-name>/SKILL.mdにあるスキルを見つけます。

• your-repo/
  • .claude/
    • skills/
      • code-review/
        • SKILL.md
      • release-process/
        • SKILL.md
        • scripts/
          • run_checks.sh
  • src/

このレイアウトに一致しない場所は、セッション開始時に検出されません。

• .claude/skills/SKILL.md：スキルディレクトリに囲まれていないSKILL.md
• .claude/skills/tools/code-review/SKILL.md：1階層より深くネストされている
• skills/code-review/SKILL.md：.claudeの外にあるskillsディレクトリ

パッケージのサブディレクトリ内など、リポジトリ内の他の場所にある.claude/skillsディレクトリは、セッション開始時にアナウンスされません。ただし、エージェントがそのサブツリー配下のファイルを読み取る際に、それらのスキルが表面化することはあります。

リポジトリスキルは、アップロードするカスタムスキルと同じSKILL.md形式を使用します。形式と作成ガイダンスについては、Agent Skillsおよびスキル作成のベストプラクティスを参照してください。

リポジトリからスキルを読み込むには、それをマウントするセッションを作成します。これはGitHubへのアクセスに示されているものと同じリクエストです。mount_pathはオプションで、デフォルトは/workspace/<repo-name>です。

SESSION_ID=$(ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID" \
  --transform id --raw-output <<'EOF'
resources:
  - type: github_repository
    url: https://github.com/org/repo
    mount_path: /workspace/repo
    authorization_token: ghp_your_github_token
EOF
)

プライベートリポジトリの場合、リソースのauthorization_tokenがリポジトリへのアクセス権を持っている必要があります。これは、あらゆるリポジトリマウントに使用されるものと同じパーソナルアクセストークンのフローです。GitHubへのアクセスを参照してください。

検出されたスキルは、リポジトリのチェックアウトされた状態に従います。リソースが設定している場合はcheckoutブランチまたはコミット、それ以外の場合はリポジトリのデフォルトブランチです。スキャンはセッション開始時に1回だけ実行されます。セッション中にプッシュされたコミットは反映されません。更新されたスキルを読み込むには、新しいセッションを開始してください。

リポジトリスキルは、エージェントのskills配列を通じて付与されたスキルと併用できます。リポジトリスキルが、付与されたスキルや別のマウントされたリポジトリのスキルと同じ名前を持つ場合、両方が利用可能になります。それぞれが独自のパスでアナウンスされます。



次のステップ