スキル

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

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

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

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



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

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

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

これらの例ではオプションの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 <<'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
YAML



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配列を通じてアタッチされたスキルと併用できます。リポジトリスキルがアタッチされたスキルや別のマウントされたリポジトリのスキルと同じ名前を持つ場合、両方が利用可能になります。それぞれが独自のパスでアナウンスされます。



次のステップ