Agent Skills

Skillsを使用する理由

Skillsは再利用可能なファイルシステムベースのリソースで、Claudeにドメイン固有の専門知識（ワークフロー、コンテキスト、ベストプラクティス）を提供し、汎用エージェントをスペシャリストに変えます。プロンプト（一回限りのタスクのための会話レベルの指示）とは異なり、Skillsはオンデマンドで読み込まれ、複数の会話にわたって同じガイダンスを繰り返し提供する必要をなくします。

主なメリット:

• Claudeを専門化する: ドメイン固有のタスクに合わせて機能をカスタマイズ
• 繰り返しを削減する: 一度作成して自動的に使用
• 機能を組み合わせる: Skillsを組み合わせて複雑なワークフローを構築

Skillsの使用

Anthropicは一般的なドキュメントタスク（PowerPoint、Excel、Word、PDF）向けに事前構築されたAgent Skillsを提供しており、独自のカスタムSkillsを作成することもできます。どちらも同じように機能します。Claudeはリクエストに関連する場合に自動的にそれらを使用します。

事前構築されたAgent Skillsはclaude.aiのすべてのユーザーおよびClaude APIを通じて利用可能です。完全なリストについては、以下の利用可能なSkillsセクションをご覧ください。

カスタムSkillsを使用すると、ドメインの専門知識と組織の知識をパッケージ化できます。Claudeの製品全体で利用可能です: Claude Codeで作成、APIを通じてアップロード、またはclaude.aiの設定で追加できます。

Skillsの仕組み

SkillsはClaudeのVM環境を活用して、プロンプトだけでは不可能な機能を提供します。Claudeはファイルシステムアクセスを持つ仮想マシンで動作し、Skillsは指示、実行可能コード、参照資料を含むディレクトリとして存在できます。これは新しいチームメンバーのために作成するオンボーディングガイドのように整理されています。

このファイルシステムベースのアーキテクチャにより、プログレッシブディスクロージャーが可能になります: Claudeは事前にコンテキストを消費するのではなく、必要に応じて段階的に情報を読み込みます。

3種類のSkillコンテンツ、3つの読み込みレベル

Skillsには3種類のコンテンツを含めることができ、それぞれ異なるタイミングで読み込まれます:

レベル1: メタデータ（常に読み込まれる）

コンテンツタイプ: 指示。SkillのYAMLフロントマターは検索情報を提供します:

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Claudeはこのメタデータを起動時に読み込み、システムプロンプトに含めます。この軽量なアプローチにより、コンテキストのペナルティなしに多くのSkillsをインストールできます。Claudeは各Skillが存在することと、いつ使用するかだけを知っています。

レベル2: 指示（トリガー時に読み込まれる）

コンテンツタイプ: 指示。SKILL.mdのメイン本文には手続き的な知識（ワークフロー、ベストプラクティス、ガイダンス）が含まれています:

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

Skillの説明に一致するリクエストをすると、ClaudeはbashでファイルシステムからSKILL.mdを読み込みます。その時点でこのコンテンツがコンテキストウィンドウに入ります。

レベル3: リソースとコード（必要に応じて読み込まれる）

コンテンツタイプ: 指示、コード、リソース。Skillsには追加の資料をバンドルできます:

pdf-skill/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)

指示: 専門的なガイダンスとワークフローを含む追加のマークダウンファイル（FORMS.md、REFERENCE.md）

コード: Claudeがbashで実行する実行可能スクリプト（fill_form.py、validate.py）。スクリプトはコンテキストを消費せずに確定的な操作を提供します

リソース: データベーススキーマ、APIドキュメント、テンプレート、例などの参照資料

Claudeはこれらのファイルが参照された場合にのみアクセスします。ファイルシステムモデルは各コンテンツタイプに異なる強みをもたらします: 柔軟なガイダンスのための指示、信頼性のためのコード、事実の参照のためのリソース。

プログレッシブディスクロージャーにより、任意の時点でコンテキストウィンドウに関連するSkillコンテンツのみが占有されます。

Skillsのアーキテクチャ

SkillsはClaudeがファイルシステムアクセス、bashコマンド、コード実行機能を持つコード実行環境で動作します。次のように考えてください: Skillsは仮想マシン上のディレクトリとして存在し、Claudeはコンピューター上のファイルをナビゲートするために使用するのと同じbashコマンドを使用してそれらと対話します。

ClaudeがSkillコンテンツにアクセスする方法:

Skillがトリガーされると、ClaudeはbashでファイルシステムからSKILL.mdを読み込み、その指示をコンテキストウィンドウに取り込みます。それらの指示が他のファイル（FORMS.mdやデータベーススキーマなど）を参照している場合、Claudeは追加のbashコマンドを使用してそれらのファイルも読み込みます。指示が実行可能スクリプトに言及している場合、Claudeはbashでそれらを実行し、出力のみを受け取ります（スクリプトコード自体はコンテキストに入りません）。

このアーキテクチャが可能にすること:

オンデマンドファイルアクセス: Claudeは各特定のタスクに必要なファイルのみを読み込みます。Skillには数十の参照ファイルを含めることができますが、タスクが販売スキーマのみを必要とする場合、Claudeはそのファイルだけを読み込みます。残りはファイルシステム上に残り、ゼロトークンを消費します。

効率的なスクリプト実行: Claudeがvalidate_form.pyを実行すると、スクリプトのコードはコンテキストウィンドウに読み込まれません。スクリプトの出力（「検証に合格しました」や特定のエラーメッセージなど）のみがトークンを消費します。これにより、スクリプトはClaudeが同等のコードをその場で生成するよりもはるかに効率的になります。

バンドルコンテンツに実質的な制限なし: ファイルはアクセスされるまでコンテキストを消費しないため、Skillsには包括的なAPIドキュメント、大規模なデータセット、豊富な例、または必要な参照資料を含めることができます。使用されないバンドルコンテンツにはコンテキストのペナルティはありません。

このファイルシステムベースのモデルがプログレッシブディスクロージャーを機能させます。Claudeはオンボーディングガイドの特定のセクションを参照するように、各タスクが必要とするものに正確にアクセスしながらSkillをナビゲートします。

例: PDFプロセッシングSkillの読み込み

ClaudeがPDFプロセッシングSkillを読み込んで使用する方法を示します:

1. 起動: システムプロンプトに含まれる: PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. ユーザーリクエスト: 「このPDFからテキストを抽出して要約してください」
3. Claudeが呼び出す: bash: read pdf-skill/SKILL.md → 指示がコンテキストに読み込まれる
4. Claudeが判断する: フォーム入力は不要なので、FORMS.mdは読み込まれない
5. Claudeが実行する: SKILL.mdの指示を使用してタスクを完了する

図が示すもの:

1. システムプロンプトとSkillメタデータが事前に読み込まれたデフォルト状態
2. ClaudeがbashでSKILL.mdを読み込んでSkillをトリガーする
3. ClaudeがFORMS.mdなどの追加バンドルファイルを必要に応じてオプションで読み込む
4. Claudeがタスクを進める

この動的な読み込みにより、関連するSkillコンテンツのみがコンテキストウィンドウを占有します。

Skillsが機能する場所

SkillsはClaudeのエージェント製品全体で利用可能です:

Claude API

Claude APIは事前構築されたAgent Skillsとカスタムの両方のSkillsをサポートします。どちらも同じように機能します: コード実行ツールとともにcontainerパラメーターに関連するskill_idを指定します。

前提条件: APIを通じてSkillsを使用するには、3つのベータヘッダーが必要です:

• code-execution-2025-08-25 - Skillsはコード実行コンテナで動作します
• skills-2025-10-02 - Skills機能を有効にします
• files-api-2025-04-14 - コンテナへのファイルのアップロード/ダウンロードに必要です

事前構築されたAgent Skillsはskill_id（例: pptx、xlsx）を参照して使用するか、Skills API（/v1/skillsエンドポイント）を通じて独自のものを作成してアップロードします。カスタムSkillsは組織全体で共有されます。

詳細については、Claude APIでSkillsを使用するをご覧ください。

Claude Code

Claude CodeはカスタムSkillsのみをサポートします。

カスタムSkills: SKILL.mdファイルを含むディレクトリとしてSkillsを作成します。Claudeはそれらを自動的に検出して使用します。

Claude CodeのカスタムSkillsはファイルシステムベースであり、APIのアップロードは不要です。

詳細については、Claude CodeでSkillsを使用するをご覧ください。

Claude Agent SDK

Claude Agent SDKはファイルシステムベースの設定を通じてカスタムSkillsをサポートします。

カスタムSkills: .claude/skills/にSKILL.mdファイルを含むディレクトリとしてSkillsを作成します。allowed_tools設定に"Skill"を含めることでSkillsを有効にします。

Agent SDKのSkillsはSDKの実行時に自動的に検出されます。

詳細については、SDKのAgent Skillsをご覧ください。

Claude.ai

Claude.aiは事前構築されたAgent Skillsとカスタムの両方のSkillsをサポートします。

事前構築されたAgent Skills: これらのSkillsはドキュメントを作成する際にすでにバックグラウンドで機能しています。Claudeはセットアップなしにそれらを使用します。

カスタムSkills: 設定 > 機能からzipファイルとして独自のSkillsをアップロードします。コード実行が有効なPro、Max、Team、Enterpriseプランで利用可能です。カスタムSkillsは各ユーザー個人のものです。組織全体では共有されず、管理者が一元管理することはできません。

Claude.aiでのSkillsの使用について詳しくは、Claudeヘルプセンターの以下のリソースをご覧ください:

• Skillsとは?
• ClaudeでSkillsを使用する
• カスタムSkillsの作成方法
• Skillsを使用してClaudeに自分の作業方法を教える

Skillの構造

すべてのSkillにはYAMLフロントマターを含むSKILL.mdファイルが必要です:

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

必須フィールド: nameとdescription

フィールド要件:

name:

• 最大64文字
• 小文字、数字、ハイフンのみを含む必要があります
• XMLタグを含めることはできません
• 予約語「anthropic」、「claude」を含めることはできません

description:

• 空でない必要があります
• 最大1024文字
• XMLタグを含めることはできません

descriptionには、Skillが何をするかとClaudeがいつ使用すべきかの両方を含める必要があります。完全なオーサリングガイダンスについては、ベストプラクティスガイドをご覧ください。

セキュリティに関する考慮事項

自分で作成したものまたはAnthropicから取得したものなど、信頼できるソースからのSkillsのみを使用することを強くお勧めします。Skillsは指示とコードを通じてClaudeに新しい機能を提供します。これにより強力になりますが、悪意のあるSkillがClaudeにSkillの記載された目的と一致しない方法でツールを呼び出したりコードを実行したりするよう指示する可能性もあります。

主なセキュリティに関する考慮事項:

• 徹底的に監査する: Skillにバンドルされているすべてのファイルを確認します: SKILL.md、スクリプト、画像、その他のリソース。予期しないネットワーク呼び出し、ファイルアクセスパターン、またはSkillの記載された目的と一致しない操作などの異常なパターンを探します
• 外部ソースはリスクがある: 外部URLからデータを取得するSkillは特にリスクがあります。取得したコンテンツに悪意のある指示が含まれている可能性があります。信頼できるSkillでも、外部依存関係が時間とともに変化すると侵害される可能性があります
• ツールの悪用: 悪意のあるSkillは有害な方法でツール（ファイル操作、bashコマンド、コード実行）を呼び出す可能性があります
• データの露出: 機密データへのアクセス権を持つSkillは、外部システムに情報を漏洩するように設計される可能性があります
• ソフトウェアのインストールと同様に扱う: 信頼できるソースからのSkillsのみを使用してください。機密データや重要な操作へのアクセス権を持つ本番システムにSkillsを統合する際は特に注意してください

利用可能なSkills

事前構築されたAgent Skills

以下の事前構築されたAgent Skillsがすぐに使用できます:

• PowerPoint (pptx): プレゼンテーションの作成、スライドの編集、プレゼンテーションコンテンツの分析
• Excel (xlsx): スプレッドシートの作成、データ分析、グラフ付きレポートの生成
• Word (docx): ドキュメントの作成、コンテンツの編集、テキストのフォーマット
• PDF (pdf): フォーマットされたPDFドキュメントとレポートの生成

これらのSkillsはClaude APIとclaude.aiで利用可能です。APIで使用を開始するにはクイックスタートチュートリアルをご覧ください。

カスタムSkillsの例

カスタムSkillsの完全な例については、Skills cookbookをご覧ください。

データ保持

Agent SkillsはZDRの取り決めの対象外です。Skillの定義と実行データはAnthropicの標準データ保持ポリシーに従って保持されます。

すべての機能にわたるZDRの適格性については、APIとデータ保持をご覧ください。

制限と制約

これらの制限を理解することで、Skillsのデプロイを効果的に計画できます。

クロスサーフェスの可用性

カスタムSkillsはサーフェス間で同期されません。あるサーフェスにアップロードされたSkillsは他のサーフェスで自動的に利用可能になりません:

• Claude.aiにアップロードされたSkillsはAPIに別途アップロードする必要があります
• APIを通じてアップロードされたSkillsはClaude.aiでは利用できません
• Claude CodeのSkillsはファイルシステムベースであり、Claude.aiとAPIの両方とは別です

使用したい各サーフェスでSkillsを個別に管理してアップロードする必要があります。

共有スコープ

Skillsは使用する場所によって異なる共有モデルを持ちます:

• Claude.ai: 個々のユーザーのみ。各チームメンバーは個別にアップロードする必要があります
• Claude API: ワークスペース全体。すべてのワークスペースメンバーがアップロードされたSkillsにアクセスできます
• Claude Code: 個人用（~/.claude/skills/）またはプロジェクトベース（.claude/skills/）。Claude Code Pluginsを通じて共有することもできます

Claude.aiは現在、カスタムSkillsの一元的な管理者管理や組織全体への配布をサポートしていません。

ランタイム環境の制約

Skillで利用可能な正確なランタイム環境は、使用する製品サーフェスによって異なります。

• Claude.ai:
  • ネットワークアクセスの変動: ユーザー/管理者の設定によっては、Skillsはフル、一部、またはネットワークアクセスなしの場合があります。詳細については、ファイルの作成と編集サポート記事をご覧ください。
• Claude API:
  • ネットワークアクセスなし: Skillsは外部API呼び出しやインターネットへのアクセスができません
  • 実行時のパッケージインストールなし: 事前インストールされたパッケージのみが利用可能です。実行中に新しいパッケージをインストールすることはできません。
  • 事前設定された依存関係のみ: 利用可能なパッケージのリストについてはコード実行ツールのドキュメントを確認してください
• Claude Code:
  • フルネットワークアクセス: Skillsはユーザーのコンピューター上の他のプログラムと同じネットワークアクセスを持ちます
  • グローバルパッケージインストールは非推奨: Skillsはユーザーのコンピューターへの干渉を避けるために、ローカルにのみパッケージをインストールする必要があります

これらの制約内で機能するようにSkillsを計画してください。

次のステップ