Agent Skills

汎用のエージェントを特定分野の専門家として動かすための仕組みです。PowerPoint・Excel・Word・PDF の文書作業向けに Anthropic が事前構築した Agent Skills があり、独自のカスタム Skill も作成できます。Skill が環境で利用可能になると、Claude はリクエストに関係するときに自動でその Skill を使います。

Claude はファイルシステムにアクセスできる仮想マシン上で動作し、Skill は指示・実行可能なコード・参考資料を含むディレクトリとして存在します。情報は必要に応じて段階的に読み込まれ (progressive disclosure)、最初からコンテキストを消費しません。

• メタデータ: 起動時に各 Skill のメタデータがシステムプロンプトに読み込まれます。トリガーされるまでは名前と説明だけがコンテキストを占めます。
• 指示: Claude はリクエストを Skill の説明と照らし合わせてトリガーするかを判断します。一致すると bash で SKILL.md をファイルシステムから読み込み、その時点で内容がコンテキストに入ります。
• リソースとコード: Skill には Claude が bash で実行するスクリプト (例: fill_form.py・validate.py) を同梱でき、コードをコンテキストに読み込まずに決まった処理を行えます。スクリプトの実行時に Claude が受け取るのは出力だけです。同梱ファイルはアクセスされるまでコンテキストを消費しないため、詳細な API ドキュメントや大きなデータセット、豊富な例を含められます。

すべての Skill には、YAML frontmatter を持つ SKILL.md ファイルが必要です。必須項目は name と description です。

• name: 64 文字以内で、小文字の英字・数字・ハイフンのみを使います。XML タグを含めず、予約語の anthropic と claude も含めません。
• description: Skill が何をするかと、Claude がいつ使うべきかの両方を含めます。Claude はリクエストをこの説明と照らし合わせて Skill をトリガーするかを判断します。

Anthropic は、一般的な文書作業向けに次の Agent Skills を用意しています。

• Excel (xlsx): スプレッドシートの作成、データ分析、グラフ付きレポートの生成
• PowerPoint (pptx): プレゼンテーションの作成、スライドの編集、プレゼンテーション内容の分析
• Word (docx): 文書の作成、内容の編集、テキストの書式設定
• PDF (pdf): 書式の整った PDF 文書やレポートの生成

claude.ai では、文書の作成時にこれらの Skill が有効になり、設定は不要です。

• Claude API でアップロードしたカスタム Skill はワークスペース全体で共有され、ワークスペースのすべてのメンバーがアクセスできます。
• API 上の Skill は、ネットワークアクセスの無いサンドボックス化されたコンテナで実行されます。使えるのは事前にインストールされたパッケージだけで、実行中に新しいパッケージはインストールできません。
• カスタム Skill は製品面の間で同期されません。ある製品面にアップロードした Skill は、ほかの製品面で自動的には使えません。
• Claude Code では、Skill はユーザーのコンピューター上のほかのプログラムと同じネットワークアクセスを持ちます。Claude Code の Skill は Claude Code plugins を通じて共有することもできます。

Claude API では、container パラメータで Skills を読み込む Messages API リクエストを含め、skills-2025-10-02 ベータヘッダーは不要です。

1. Claude API のリクエストで、container パラメータに使用する skill_id を指定し、code execution tool と一緒に渡します。
2. 事前構築された Agent Skills を使う場合は、skill_id として pptx・xlsx・docx・pdf のいずれかを参照します。
3. 独自の Skill を使う場合は、Skills API (/v1/skills エンドポイント) で作成してアップロードします。