Agent Skills

Skillsを使用する理由

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

主な利点:

• Claudeを専門化する: ドメイン固有のタスク用に機能をカスタマイズする
• 繰り返しを削減する: 1回作成して、自動的に使用する
• 機能を構成する: 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の仮想マシン環境を活用します。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はこれらのファイルに参照されたときのみアクセスします。ファイルシステムモデルは、各コンテンツタイプが異なる強みを持つことを意味します。指示は柔軟なガイダンス、コードは信頼性、リソースは事実上の検索です。

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

Skillsアーキテクチャ

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

Claudeがスキルコンテンツにアクセスする方法：

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

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

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

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

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

このファイルシステムベースのモデルは、段階的な情報開示を機能させるものです。Claudeはオンボーディングガイドの特定のセクションを参照するのと同じように、Skillをナビゲートし、各タスクが必要とするものに正確にアクセスします。

例：PDFプロセッシングスキルの読み込み

Claudeがどのようにして、PDFプロセッシングスキルを読み込んで使用するかを示します：

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. システムプロンプトとスキルメタデータが事前に読み込まれたデフォルト状態
2. Claudeがbashを介してSKILL.mdを読み込むことでスキルをトリガーする
3. Claudeが必要に応じてFORMS.mdなどの追加バンドルファイルを読み込む
4. Claudeがタスクを進める

この動的読み込みにより、関連するスキルコンテンツのみがコンテキストウィンドウを占有することが保証されます。

Skillsが機能する場所

Skillsはクラウドのエージェント製品全体で利用可能です：

Claude API

Claude APIは、事前構築されたAgent 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.ai

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

事前構築されたAgent Skills：これらのSkillsは、ドキュメントを作成するときにすでに背後で機能しています。Claudeはセットアップを必要とせずにそれらを使用します。

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

Claude.aiでSkillsを使用する方法の詳細については、Claude Help Centerの次のリソースを参照してください：

• Skillsとは何ですか？
• Claudeでのスキルの使用
• カスタムスキルを作成する方法
• Skillsを使用してClaudeの作業方法を教える

スキル構造

すべての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がいつそれを使用すべきかの両方を含める必要があります。完全なオーサリングガイダンスについては、ベストプラクティスガイドを参照してください。

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

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

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

• 徹底的に監査する：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.aiで利用可能です。クイックスタートチュートリアルを参照して、APIでの使用を開始してください。

オープンソースSkills

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

• Claude API：Claudeに最新のAPIリファレンス資料、SDK ドキュメンテーション、および8つのプログラミング言語のベストプラクティスを提供します。Claude Codeにバンドルされており、スキルリポジトリからのインストールにも利用可能です。

カスタムSkillsの例

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

データ保持

Agent SkillsはZDR契約の対象ではありません。スキル定義と実行データは、Anthropicの標準データ保持ポリシーに従って保持されます。

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

制限事項と制約

これらの制限事項を理解することは、Skillsのデプロイメントを効果的に計画するのに役立ちます。

クロスサーフェス可用性

カスタムSkillsはサーフェス間で同期されません。1つのサーフェスにアップロードされた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の一元管理または組織全体の配布をサポートしていません。

ランタイム環境の制約

スキルで利用可能な正確なランタイム環境は、使用する製品サーフェスに依存します。

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

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

次のステップ