スキル

スキルは、エージェントにドメイン固有の専門知識を与える、再利用可能なファイルシステムベースのリソースです。ワークフロー、コンテキスト、ベストプラクティスによって、汎用エージェントをスペシャリストに変えます。追加する各スキルは、モデルがスキルを使用するのに役立つ指示とメタデータを追加するため、セッションの「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にはベータヘッダーは必要ありません。引き続きanthropic-beta: skills-2025-10-02を送信するリクエストも動作し続け、以前のレスポンスフィールドを返します。

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

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



次のステップ