Agent Skills



Skillsを使用する理由

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

主な利点:

• Claudeの専門化: ドメイン固有のタスクに合わせて機能をカスタマイズ
• 繰り返しの削減: 一度作成すれば、自動的に使用される
• 機能の組み合わせ: 複雑でマルチステップのタスクのためにSkillsを組み合わせる



Skillsの使用

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

事前構築済みAgent Skillsは、claude.ai、Claude API、Claude Platform on AWS、およびMicrosoft Foundryで利用できます。Microsoft Foundryでは、Agent SkillsにはHosted on Anthropicデプロイメントが必要です。完全なリストについては、利用可能なSkillsを参照してください。

カスタムSkillsを使用すると、ドメインの専門知識や組織の知識をパッケージ化できます。これらはClaudeの製品全体で利用できます。Claude Codeで作成したり、Claude APIを通じてアップロードしたり、claude.aiの設定で追加したりできます。Claude Platform on AWSおよびMicrosoft Foundryでは、Skills APIを通じてカスタムSkillsをアップロードします。



Skillsの仕組み

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

このファイルシステムベースのアーキテクチャにより、**段階的開示（progressive disclosure）**が可能になります。Claudeは、コンテキストを事前に消費するのではなく、必要に応じて段階的に情報を読み込みます。

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は起動時にこのメタデータを読み込み、システムプロンプトに含めます。descriptionは、Skillをトリガーするかどうかを判断する際にClaudeがリクエストと照合するものであるため、Skillが何をするのか、いつ使用するのかの両方を記述する必要があります。この軽量なアプローチにより、コンテキストのペナルティなしに多くのSkillsをインストールできます。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-processing/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)

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

コード: Claudeがbashを使用して実行する実行可能スクリプト（fill_form.py、validate.py）。コードをコンテキストに読み込むことなく、決定論的な操作を提供します

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

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

段階的開示により、任意の時点で関連するコンテンツのみがコンテキストウィンドウを占有することが保証されます。



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を実行するとき、スクリプトのコードがコンテキストウィンドウに読み込まれることはありません。その出力（「Validation passed」や特定のエラーメッセージなど）のみがトークンを消費するため、Claudeがその場で同等のコードを生成するよりもスクリプトの方がはるかに効率的です。
• バンドルされたコンテンツに実質的な制限なし: ファイルはアクセスされるまでコンテキストを消費しないため、Skillsには包括的なAPIドキュメント、大規模なデータセット、または広範な例を含めることができます。使用されないバンドルコンテンツにコンテキストのペナルティはありません。



例: PDF処理Skillの読み込み

以下は、Claudeが前述の例のカスタムpdf-processing Skill（事前構築済みのpdf Skillではありません）を読み込んで使用する方法です。

1. 起動: システムプロンプトに以下が含まれます: pdf-processing - 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.
2. ユーザーリクエスト: 「このPDFからテキストを抽出して要約して」
3. Claudeの呼び出し: bash: cat pdf-processing/SKILL.md → 指示がコンテキストに読み込まれる
4. Claudeの判断: フォーム入力は不要なため、FORMS.mdは読み取られない
5. Claudeの実行: SKILL.mdの指示を使用してタスクを完了する



Skillsが動作する場所

Skillsは、Claudeのエージェント製品全体で利用できます。



Claude API

Claude APIは、事前構築済みAgent SkillsとカスタムSkillsの両方をサポートしています。どちらも同じように動作します。コード実行ツールとともに、containerパラメータに関連するskill_idを指定します。

前提条件: APIを通じてSkillsを使用するには、Skillsが実行されるコンテナを提供するコード実行ツールと、1つのベータヘッダーが必要です。

• skills-2025-10-02 - Skills機能を有効にします

Files APIを使用してコンテナに入力ファイルをアップロードしたり、Skillが生成したファイルをダウンロードしたりする場合は、2つ目のヘッダーfiles-api-2025-04-14を追加します。

事前構築済みAgent Skillsは、そのskill_id（pptx、xlsx、docx、またはpdf）を参照して使用するか、Skills API（/v1/skillsエンドポイント）を通じて独自のSkillsを作成してアップロードします。カスタムSkillsはワークスペース全体で共有されます。すべてのワークスペースメンバーがアクセスできます。

API上のSkillsは、ネットワークアクセスなし、ランタイムパッケージインストールなしのサンドボックス化されたコンテナで実行されます。詳細については、制限事項と制約を参照してください。

詳細については、APIでのAgent Skillsの使用を参照してください。



Claude Code

Claude CodeはカスタムSkillsをサポートしています。事前構築済みのドキュメントSkills（PowerPoint、Excel、Word、PDF）はClaude Codeでは利用できませんが、オープンソースのClaude API skillはバンドルされています。Claude Codeに付属する組み込みコマンドとSkillsの完全なリストを参照してください。

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

Claude CodeのカスタムSkillsはファイルシステムベースであり、APIへのアップロードは不要です。~/.claude/skills/（個人用）または.claude/skills/（プロジェクト用）に配置します。

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



claude.ai

claude.aiは、事前構築済みAgent SkillsとカスタムSkillsの両方をサポートしています。

事前構築済みAgent Skills: これらのSkillsは、ドキュメントを作成するときにアクティブになります。Claudeはセットアップ不要でそれらを使用します。

カスタムSkills: 設定 > 機能から、独自のSkillsをzipファイルとしてアップロードします。コード実行が有効な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がいつそれを使用すべきかの両方を含める必要があります。完全な作成ガイダンスについては、Skill作成のベストプラクティスを参照してください。



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

Skillsは信頼できるソース（自分で作成したもの、またはAnthropicから入手したもの）からのみ使用してください。Skillsは指示とコードを通じてClaudeに新しい機能を与えますが、これは悪意のあるSkillが、Skillの表明された目的と一致しない方法でツールを呼び出したりコードを実行したりするようにClaudeに指示できることも意味します。

主なセキュリティ上の考慮事項:

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

組織規模のガバナンス、審査、デプロイメントのガイダンスについては、エンタープライズ向けSkillsを参照してください。



利用可能なSkills



事前構築済みAgent Skills

以下の事前構築済みAgent Skillsがすぐに使用できます。

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

これらのSkillsは、Claude API、Claude Platform on AWS、Microsoft Foundry、およびclaude.aiで利用できます。APIでの使用を開始するには、クイックスタートチュートリアルを参照してください。



オープンソースSkills

Anthropicは、skillsリポジトリでオープンソースSkillsも公開しています。

• Claude API skill: 8つのプログラミング言語に対応した最新のAPIリファレンス資料、SDKドキュメント、ベストプラクティスをClaudeに提供します。Claude Codeにバンドルされており、skillsリポジトリからインストールすることもできます。



カスタムSkillsの例

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



データ保持

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

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



制限事項と制約

Claude Platform on AWSとMicrosoft Foundryは、以下のサブセクションにおいてClaude APIと同じ制限に従います。



サーフェス間の可用性

カスタム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は完全な、部分的な、またはまったくないネットワークアクセスを持つ場合があります。詳細については、Create and Edit Filesサポート記事を参照してください。
• Claude API:
  • ネットワークアクセスなし: Skillsは外部API呼び出しやインターネットへのアクセスができません。
  • ランタイムパッケージインストールなし: 事前にインストールされたパッケージのみが利用可能です。実行中に新しいパッケージをインストールすることはできません。
  • 事前設定された依存関係のみ: 利用可能なパッケージのリストについては、コード実行ツールのドキュメントを確認してください。
• Claude Code:
  • 完全なネットワークアクセス: Skillsは、ユーザーのコンピュータ上の他のプログラムと同じネットワークアクセスを持ちます。
  • グローバルパッケージインストールは非推奨: ユーザーのコンピュータへの干渉を避けるため、Skillsはパッケージをローカルにのみインストールすべきです。

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



次のステップ