Agent Skills

Agent Skills は、Claude の機能を拡張するモジュール式の機能です。各 Skill は、Claude が関連する場合に自動的に使用する手順、メタデータ、およびオプションのリソース（スクリプト、テンプレート）をパッケージ化します。

Skills を使用する理由

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

主な利点：

• Claude の専門化: ドメイン固有のタスクに合わせて機能を調整
• 繰り返しの削減: 一度作成すれば、自動的に使用可能
• 機能の構成: 複数の Skill を組み合わせて複雑なワークフローを構築

Agent Skills のアーキテクチャと実際のアプリケーションの詳細については、エンジニアリングブログ Equipping agents for the real world with Agent 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 の設定で追加します。

始め方：

• 事前構築済み Agent Skills の場合: API で PowerPoint、Excel、Word、PDF のスキルを使用し始めるには、クイックスタートチュートリアル を参照してください。
• カスタム Skills の場合: 独自の Skills を作成する方法については、Agent Skills Cookbook を参照してください。

Skills の仕組み

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

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

3つの Skill コンテンツタイプ、3つのロードレベル

Skills には3種類のコンテンツを含めることができ、それぞれ異なるタイミングでロードされます。

レベル 1：メタデータ（常にロードされる）

コンテンツタイプ: 指示。Skill の YAML frontmatter は発見情報を提供します：

---
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 のエージェント製品全体で利用できます：

Claude API

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

前提条件: API 経由で Skills を使用するには、3つのベータヘッダーが必要です：

• code-execution-2025-08-25 - Skills はコード実行コンテナで実行されます
• skills-2025-10-02 - Skills 機能を有効にします
• files-api-2025-04-14 - コンテナへのファイルのアップロード/ダウンロードに必要です

skill_id（例：pptx, xlsx）を参照して事前構築済み Agent Skills を使用するか、Skills API（/v1/skills エンドポイント）を使用して独自の Skills を作成してアップロードします。カスタム Skills は組織全体で共有されます。

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

Claude Code

Claude Code はカスタム Skills のみをサポートしています。

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

Claude Code のカスタム Skills はファイルシステムベースであり、API アップロードを必要としません。 詳細については、Claude Code での Skills の使用 を参照してください。

Claude Agent SDK

Claude Agent SDK は、ファイルシステムベースの構成を通じてカスタム Skills をサポートしています。

カスタム Skills: .claude/skills/ 内に SKILL.md ファイルを含むディレクトリとして Skills を作成します。allowed_tools 設定に "Skill" を含めることで Skills を有効にします。

Agent SDK の Skills は、SDK の実行時に自動的に発見されます。 詳細については、SDK の Agent Skills を参照してください。

Claude.ai

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

• 事前構築済み Agent Skills: これらの Skills は、ドキュメントを作成するときにバックグラウンドですでに機能しています。Claude は設定なしでそれらを使用します。
• カスタム Skills: 設定 > 機能 (Settings > Features) から zip ファイルとして独自の Skills をアップロードします。コード実行が有効になっている Pro、Max、Team、Enterprise プランで利用可能です。カスタム Skills は各ユーザーに個別です。組織全体で共有されず、管理者が一元的に管理することもできません。

Claude.ai での Skills の使用に関する詳細については、Claude ヘルプセンターの次のリソースを参照してください：

• Skills とは?
• Claude での Skills の使用
• カスタム Skills の作成方法
• Skills を使用して Claude に自分の作業方法を教える

Skill の構造

すべての Skill には、YAML frontmatter を持つ 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 タグを含めることはできません

説明には、Skill が何をするか、および Claude がいつそれを使用すべきかの両方を含める必要があります。完全な作成ガイダンスについては、ベストプラクティスガイド を参照してください。

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

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

信頼できない、または不明なソースからの Skill を使用する必要がある場合は、使用前に細心の注意を払い、徹底的に監査してください。Skill の実行時に Claude が持つアクセス権によっては、悪意のある Skills がデータの抽出、不正なシステムアクセス、その他のセキュリティリスクにつながる可能性があります。

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

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