スキル

スキルは、エージェントにドメイン固有の専門知識を与える、再利用可能なファイルシステムベースのリソースです。汎用エージェントをスペシャリストに変えるワークフロー、コンテキスト、ベストプラクティスを提供します。追加する各スキルは、セッションの「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 の事前構築済みスキルはすべてのワークスペースですでに利用可能であり、この手順は不要です。事前構築済みスキルのみを使用する場合は、エージェントにスキルをアタッチするに進んでください。

これらの例ではオプションの display_name フィールドを省略しているため、スキルの表示名は SKILL.md の name フィールドから導出されます。明示的な display_name は最大255文字まで指定でき、ワークスペース内で一意である必要はありません。

ant apply skills/pr-summary

---
name: pr-summary
description: Summarize a pull request's changes and risks in the team's review format.
---

# PR summary

List what changed, why, and anything a reviewer should look at closely, in three short sections.

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

エージェントにスキルをアタッチする

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

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

ant apply agent.md

---
name: Financial Analyst
model: claude-opus-5-5
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest
---

You are a financial analysis agent.

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 = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "github_repository",
            "url": "https://github.com/org/repo",
            "mount_path": "/workspace/repo",
            "authorization_token": "ghp_your_github_token",
        },
    ],
)

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

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

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

次のステップ