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には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コマンドを使ってSkillsとやり取りします。

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が判断する： フォームの入力は不要なため、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を作成してアップロードします。カスタムSkillsはワークスペース全体で共有され、すべてのワークスペースメンバーがアクセスできます。

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

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

Claude Code

Claude CodeはカスタムSkillsをサポートしています。事前構築済みのドキュメントSkills（PowerPoint、Excel、Word、PDF）はClaude Codeでは利用できませんが、オープンソースのClaude APIスキルがバンドルされています。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、Ultra、Team、Enterpriseプランでコード実行を有効にしている場合に利用できます。

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：

• 空であってはなりません
• 最大1,024文字
• 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スキル： 最新のAPIリファレンス資料、SDKドキュメント、および8つのプログラミング言語向けのベストプラクティスをClaudeに提供します。Claude Codeにバンドルされており、skillsリポジトリからインストールすることもできます。

カスタムSkillsの例

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

データ保持

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

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

制限と制約

Claude Platform on AWSおよびMicrosoft Foundryは、以下のサブセクションにおいてClaude APIと同じ制限に従います。さらに、Microsoft Foundryでは、SkillバージョンのダウンロードエンドポイントAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。（GET /v1/skills/{skill_id}/versions/{version}/content）は利用できません。

サーフェス間の可用性

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

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

使用したい各サーフェスごとに、Skillsを個別に管理およびアップロードしてください。

共有スコープ

Skillsは、使用する場所によって共有モデルが異なります。

• Claude API： ワークスペース全体。すべてのワークスペースメンバーがアップロードされたSkillsにアクセスできます。
• Claude Code： 個人用（~/.claude/skills/）またはプロジェクトベース（.claude/skills/）。Claude Codeのプラグインを通じて共有することもできます。

ランタイム環境の制約

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

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

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

次のステップ

利用可能状況