---
title: Agent Skills
url: https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/overview
description: Agent Skillsは、Claudeの機能を拡張するモジュール式の機能です。各Skillは、指示、メタデータ、およびオプションのリソース（スクリプト、テンプレート）をパッケージ化しており、Claudeは関連する場合にそれらを自動的に使用します。
---
「zero data retention」（ゼロデータ保持）、すなわちZDRがこの機能にどのように適用されるかについては、[APIとデータ保持](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention)を参照してください。
## Skillsを使用する理由
Skillsは、Claudeにドメイン固有の専門知識を与える、再利用可能なファイルシステムベースのリソースです。汎用エージェントをスペシャリストに変えるワークフロー、コンテキスト、ベストプラクティスを提供します。プロンプト（1回限りのタスクのための会話レベルの指示）とは異なり、Skillsはオンデマンドで読み込まれるため、会話をまたいで同じガイダンスを繰り返す必要がありません。
**主なメリット：**
* **Claudeを専門化する：** ドメイン固有のタスクに合わせて機能を調整
* **繰り返しを削減する：** 一度作成すれば、自動的に使用される
* **機能を組み合わせる：** 複雑な複数ステップのタスクのためにSkillsを組み合わせる
Agent Skillsのアーキテクチャと実際の応用例の詳細については、エンジニアリングブログ記事[Equipping agents for the real world with Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)を参照してください。
## Skillsの使用
Anthropicは、一般的なドキュメントタスク（PowerPoint、Excel、Word、PDF）向けの事前構築済みAgent Skillsを提供しており、独自のカスタムSkillsを作成することもできます。どちらも同じように動作します。Skillが環境内で利用可能になると、Claudeはリクエストに関連する場合にそれを自動的に使用します。
**事前構築済みAgent Skills**は、claude.ai、Claude API、[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)、および[Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)で利用できます。Microsoft Foundryでは、Agent Skillsには[Hosted on Anthropicデプロイメント](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry#additional-features-not-supported-when-hosted-on-azure)が必要です。完全なリストについては[利用可能なSkills](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/overview#available-skills)を参照してください。
**カスタムSkills**を使用すると、ドメインの専門知識や組織のナレッジをパッケージ化できます。これらはClaudeの各製品で利用できます。Claude Codeで作成したり、Claude API経由でアップロードしたり、claude.aiの設定で追加したりできます。[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)および[Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)では、Skills API経由でカスタムSkillsをアップロードします。
**はじめに：**
* 事前構築済みAgent Skillsの場合：APIでPowerPoint、Excel、Word、PDFのSkillsを使い始めるには、[クイックスタートチュートリアル](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/quickstart)を参照してください
* カスタムSkillsの場合：独自のSkillsの作成方法を学ぶには、[Agent Skills Cookbook](https://platform.claude.com/cookbook/skills-notebooks-01-skills-introduction)を参照してください
## Skillsの仕組み
Skillsは、ClaudeのVM環境を使用して、プロンプトだけでは実現できない機能を提供します。Claudeはファイルシステムにアクセスできる仮想マシン内で動作するため、Skillsは指示、実行可能コード、参考資料を含むディレクトリとして存在でき、新しいチームメンバーのために作成するオンボーディングガイドのように整理されています。
このファイルシステムベースのアーキテクチャにより、**「progressive disclosure」（段階的開示）**が可能になります。Claudeはコンテキストを事前に消費するのではなく、必要に応じて段階的に情報を読み込みます。
Skillsには3種類のコンテンツを含めることができ、それぞれ異なるタイミングで読み込まれます。
### レベル1：メタデータ（常に読み込まれる）
SkillのYAMLフロントマターは、検出のための情報を提供します。
```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の本文には、手続き的な知識（ワークフロー、ベストプラクティス、ガイダンス）が含まれます。
````markdown
# 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`（ユーティリティスクリプト）
**指示：** 専門的なガイダンスとワークフローを含む追加のMarkdownファイル（FORMS.md、REFERENCE.md）
**コード：** Claudeがbashを使用して実行する実行可能スクリプト（fill\_form.py、validate.py）。コードをコンテキストに読み込むことなく、決定論的な操作を提供します
**リソース：** データベーススキーマ、APIドキュメント、テンプレート、例などの参考資料
Claudeは、参照された場合にのみこれらのファイルにアクセスします。ファイルシステムモデルにより、各コンテンツタイプにはそれぞれ異なる強みがあります。指示は柔軟なガイダンスに、コードは信頼性に、リソースは事実の参照に適しています。
| レベル | 読み込みタイミング | トークンコスト | コンテンツ |
| --------------- | --------------- | ---------------- | -------------------------------------------------------------------------------- |
| **レベル1：メタデータ** | 常時（起動時） | Skillごとに約100トークン | YAMLフロントマターの`name`と`description` |
| **レベル2：指示** | Skillがトリガーされたとき | 5kトークン未満 | 指示とガイダンスを含むSKILL.mdの本文 |
| **レベル3以降：リソース** | 必要に応じて | アクセスされるまでなし | バンドルされたファイル。参照ファイルは読み取られたときにコンテキストに読み込まれます。スクリプトはbashを通じて実行され、その出力のみがコンテキストに入ります |
段階的開示により、常に関連するコンテンツのみがコンテキストウィンドウを占有するようになります。
### 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が判断する：** フォーム入力は不要なため、FORMS.mdは読み取られません
5. **Claudeが実行する：** SKILL.mdの指示を使用してタスクを完了します
## Skillsが動作する場所
Skillsは、Claudeのエージェント製品全体で利用できます。
Claude Platform on AWSおよびMicrosoft Foundryは、[制限と制約](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/overview#limitations-and-constraints)で別途記載されている場合を除き、以下のすべてのセクションでClaude APIと同じSkillsの動作を継承します。
### Claude API
Claude APIは、事前構築済みAgent SkillsとカスタムSkillsの両方をサポートしています。どちらも同じように機能します。[コード実行ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)とともに、`container`パラメータで該当する`skill_id`を指定します。
**前提条件：** APIを通じてSkillsを使用するには、[コード実行ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)が必要です。Skillsはそのコンテナ内で実行されます。
事前構築済みAgent Skillsは、その`skill_id`（`pptx`、`xlsx`、`docx`、または`pdf`）を参照して使用するか、Skills API（`/v1/skills`エンドポイント）を通じて独自のSkillsを作成してアップロードします。カスタムSkillsはワークスペース全体で共有され、すべてのワークスペースメンバーがアクセスできます。
API上のSkillsは、ネットワークアクセスがなく、実行時のパッケージインストールもできないサンドボックス化されたコンテナで実行されます。詳細については、[制限と制約](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/overview#limitations-and-constraints)を参照してください。
詳細については、[APIでAgent Skillsを使用する](https://platform.claude.com/docs/ja/build-with-claude/skills-guide)を参照してください。
### Claude Code
[Claude Code](https://code.claude.com/docs/en/overview)はカスタムSkillsをサポートしています。事前構築済みのドキュメントSkills（PowerPoint、Excel、Word、PDF）はClaude Codeでは利用できませんが、オープンソースの[Claude API skill](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/claude-api-skill)がバンドルされています。Claude Codeに同梱されている[組み込みコマンドとSkills](https://code.claude.com/docs/en/commands)の完全なリストを参照してください。
**カスタムSkills：** SKILL.mdファイルを含むディレクトリとしてSkillsを作成します。Claudeはそれらを自動的に検出して使用します。
Claude CodeのカスタムSkillsはファイルシステムベースであり、APIへのアップロードは不要です。`~/.claude/skills/`（個人用）または`.claude/skills/`（プロジェクト用）に配置してください。
詳細については、[Claude CodeでSkillsを使用する](https://code.claude.com/docs/ja/skills)を参照してください。
### claude.ai
[claude.ai](https://claude.ai)は、事前構築済みAgent SkillsとカスタムSkillsの両方をサポートしています。
**事前構築済みAgent Skills：** これらのSkillsは、ドキュメントを作成するときに有効になります。Claudeはセットアップ不要でこれらを使用します。
**カスタムSkills：**設定 > 機能から、独自のSkillsをzipファイルとしてアップロードできます。Pro、Max、Team、Enterpriseプランで[コード実行を有効にしている](https://support.claude.com/en/articles/12111783-create-and-edit-files-with-claude)場合に利用できます。カスタムSkillsは各ユーザー個別のものです。組織全体で共有されることはなく、管理者が一元管理することもできません。
claude.aiでのSkillsの使用について詳しくは、Claudeヘルプセンターの以下のリソースを参照してください。
* [Skillsとは？](https://support.claude.com/en/articles/12512176-what-are-skills)
* [ClaudeでSkillsを使用する](https://support.claude.com/en/articles/12512180-using-skills-in-claude)
* [カスタムSkillsの作成方法](https://support.claude.com/en/articles/12512198-creating-custom-skills)
* [Skillsを使ってClaudeにあなたの仕事の進め方を教える](https://support.claude.com/en/articles/12580051-teach-claude-your-way-of-working-using-skills)
## Skillの構造
すべてのSkillには、YAMLフロントマターを含む`SKILL.md`ファイルが必要です。
```markdown
---
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作成のベストプラクティス](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/best-practices)を参照してください。
## セキュリティに関する考慮事項
Skillsは信頼できるソース（自分で作成したもの、またはAnthropicから入手したもの）からのみ使用してください。Skillsは指示とコードを通じてClaudeに新しい機能を与えますが、これは同時に、悪意のあるSkillがSkillの表明された目的と一致しない方法でツールを呼び出したりコードを実行したりするようClaudeに指示できることも意味します。
信頼できない、または不明なソースからのSkillを使用しなければならない場合は、細心の注意を払い、使用前に徹底的に監査してください。Skillの実行時にClaudeがどのようなアクセス権を持っているかによっては、悪意のあるSkillsがデータの流出、不正なシステムアクセス、その他のセキュリティリスクにつながる可能性があります。
**主なセキュリティ上の考慮事項：**
* **徹底的に監査する：** Skillにバンドルされているすべてのファイル（SKILL.md、スクリプト、画像、その他のリソース）を確認してください。予期しないネットワーク呼び出し、ファイルアクセスパターン、Skillの表明された目的と一致しない操作など、異常なパターンを探してください
* **外部ソースはリスクが高い：** 外部URLからデータを取得するSkillsは、取得したコンテンツに悪意のある指示が含まれている可能性があるため、特にリスクがあります。信頼できるSkillsであっても、外部の依存関係が時間とともに変化すると侵害される可能性があります
* **ツールの悪用：** 悪意のあるSkillsは、ツール（ファイル操作、bashコマンド、コード実行）を有害な方法で呼び出す可能性があります
* **データの露出：** 機密データにアクセスできるSkillsは、外部システムに情報を漏洩するように設計されている可能性があります
* **ソフトウェアのインストールと同様に扱う：** 機密データや重要な操作にアクセスできる本番システムにSkillsを統合する場合は、特に注意してください
組織規模のガバナンス、審査、デプロイメントのガイダンスについては、[エンタープライズ向けSkills](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/enterprise)を参照してください。Claude Enterprise組織は、claude.aiおよびClaude CoworkでアップロードされたカスタムSkillsに対して[Skillコンテンツスキャン](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/enterprise#skill-content-scanning)を有効にすることもできます。スキャンは、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](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)、[Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)、およびclaude.aiで利用できます。APIで使い始めるには、[クイックスタートチュートリアル](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/quickstart)を参照してください。
### オープンソースSkills
Anthropicは、[skillsリポジトリ](https://github.com/anthropics/skills)でオープンソースのSkillsも公開しています。
* **[Claude API skill](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/claude-api-skill)：** 最新のAPIリファレンス資料、SDKドキュメント、および8つのプログラミング言語向けのベストプラクティスをClaudeに提供します。Claude Codeにバンドルされており、skillsリポジトリからインストールすることもできます。
### カスタムSkillsの例
カスタムSkillsの完全な例については、[Skills cookbook](https://platform.claude.com/cookbook/skills-notebooks-01-skills-introduction)を参照してください。
## データ保持
Agent SkillsはZDRの取り決めの対象外です。Skillの定義と実行データは、Anthropicの標準データ保持ポリシーに従って保持されます。
すべての機能にわたるZDRの適格性については、[APIとデータ保持](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention)を参照してください。
Skills API操作の監査ログについては、「APIでAgent Skillsを使用する」の[監査ログ](https://platform.claude.com/docs/ja/build-with-claude/skills-guide#audit-logging)を参照してください。
## 制限と制約
Claude Platform on AWSおよびMicrosoft Foundryは、以下のサブセクションにおいてClaude APIと同じ制限に従います。さらに、Microsoft Foundryでは、[Skillバージョンのダウンロードエンドポイント](https://platform.claude.com/docs/ja/api/beta/skills/versions/download)（`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.ai：** 個々のユーザーのみ。各チームメンバーが個別にアップロードする必要があります。
* **Claude API：** ワークスペース全体。すべてのワークスペースメンバーがアップロードされたSkillsにアクセスできます。
* **Claude Code：** 個人用（`~/.claude/skills/`）またはプロジェクトベース（`.claude/skills/`）。Claude Code Pluginsを通じて共有することもできます。
claude.aiは、カスタムSkillsの管理者による一元管理や組織全体への配布をサポートしていません。
### ランタイム環境の制約
Skillで利用できる正確なランタイム環境は、使用する製品サーフェスによって異なります。
* **claude.ai：**
* **ネットワークアクセスは可変：** ユーザー/管理者の設定に応じて、Skillsは完全、部分的、またはネットワークアクセスなしのいずれかになります。詳細については、サポート記事[Create and Edit Files](https://support.claude.com/en/articles/12111783-create-and-edit-files-with-claude#h_6b7e833898)を参照してください。
* **Claude API：**
* **ネットワークアクセスなし：** Skillsは外部API呼び出しを行ったり、インターネットにアクセスしたりすることはできません。
* **実行時のパッケージインストール不可：** 事前にインストールされたパッケージのみが利用可能です。実行中に新しいパッケージをインストールすることはできません。
* **事前設定された依存関係のみ：** 利用可能なパッケージのリストについては、[コード実行ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)のドキュメントを確認してください。
* **Claude Code：**
* **完全なネットワークアクセス：** Skillsは、ユーザーのコンピュータ上の他のプログラムと同じネットワークアクセスを持ちます。
* **グローバルなパッケージインストールは非推奨：** ユーザーのコンピュータに干渉しないよう、Skillsはパッケージをローカルにのみインストールすべきです。
これらの制約の範囲内で動作するようにSkillsを計画してください。
## 次のステップ
Claude APIでAgent Skillsを使用してドキュメントを作成する方法を10分以内で学びます。
API経由でAgent Skillsを使用してClaudeの機能を拡張する方法を学びます。
Claude CodeでカスタムSkillsを作成および管理します。
Claudeが検出して正しく使用できる効果的なSkillsの書き方を学びます。