Agent Skills

Skillsを使用する理由

Skillsは、Claudeにドメイン固有の専門知識を与える、再利用可能なファイルシステムベースのリソースです。汎用エージェントをスペシャリストに変えるワークフロー、コンテキスト、ベストプラクティスを提供します。プロンプト（1回限りのタスクのための会話レベルの指示）とは異なり、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は、ClaudeがSkillをトリガーするかどうかを判断する際にリクエストと照合する対象であるため、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を読み取ります。そのときに初めて、このコンテンツが「context window」（コンテキストウィンドウ）に入ります。

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

Skillsには追加の資料をバンドルできます。

• pdf-processing/
  • SKILL.md（メインの指示）
  • FORMS.md（フォーム入力ガイド）
  • REFERENCE.md（詳細なAPIリファレンス）
  • scripts/
    • fill_form.py（ユーティリティスクリプト）

指示： 専門的なガイダンスとワークフローを含む追加のマークダウンファイル（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が読み込むのはその1つのファイルだけです。残りはファイルシステム上に留まり、トークンコストはゼロです。
• 効率的なスクリプト実行： 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はそのコンテナ内で実行されます。

事前構築済みAgent Skillsはskill_id（pptx、xlsx、docx、またはpdf）を参照して使用するか、Skills API（/v1/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ヘルプセンターの以下のリソースを参照してください。

• What are Skills?
• Using Skills in Claude
• How to create custom Skills
• Teach Claude your way of working using Skills

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を参照してください。Claude Enterprise組織は、claude.aiおよびClaude CoworkでアップロードされたカスタムSkillsに対してSkillコンテンツスキャンを有効にすることもできます。スキャンは、Skills APIまたはClaude Console経由でアップロードされた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： 最新のAPIリファレンス資料、SDKドキュメント、および8つのプログラミング言語向けのベストプラクティスをClaudeに提供します。Claude Codeにバンドルされており、skillsリポジトリからインストールすることもできます。

カスタムSkillsの例

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

データ保持

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

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

Skills API操作の監査ログについては、「APIでAgent Skillsを使用する」の監査ログを参照してください。

制限と制約

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を計画してください。

次のステップ