スキルは、無料、Pro、Max、Team、およびEnterpriseプランのユーザーが利用できます。この機能にはコード実行を有効にすることが必要です。スキルはClaudeコードユーザーおよびコード実行ツールを使用するすべてのAPIユーザーのベータ版でも利用可能です。
カスタムスキルを使用すると、組織または個人の作業スタイルに固有の専門知識とワークフローでClaudeを強化できます。この記事では、独自のスキルを作成、構造化、テストする方法について説明します。
スキルは、数行の指示のようにシンプルなものから、実行可能なコードを含むマルチファイルパッケージのように複雑なものまで様々です。最高のスキルは以下の特徴があります：
特定の反復可能なタスクを解決する
Claudeが従うことができる明確な指示を持つ
役立つ場合は例を含める
使用すべき時期を定義する
すべてを行おうとするのではなく、1つのワークフローに焦点を当てている
skill.mdファイルを作成する
すべてのスキルは、最小限でもskill.mdファイルを含むディレクトリで構成されます。このファイルはスキルのコアです。このファイルは、必須メタデータであるnameおよびdescriptionフィールドを保持するYAML frontmatterで始まる必要があります。また、追加のメタデータ、Claudeの指示またはリファレンスファイル、実行可能スクリプト、またはツールを含めることもできます。
必須メタデータフィールド
name: スキルの人間にわかりやすい名前（最大64文字）
例： ブランドガイドライン
description: スキルが何をするか、いつ使用するかについての明確な説明。
これは重要です。Claudeはこれを使用してスキルを呼び出すかどうかを判断します（最大200文字）。
例： プレゼンテーションとドキュメントにAcme Corpブランドガイドラインを適用します。公式の色、フォント、ロゴの使用法を含みます。
オプションのメタデータフィールド
dependencies: スキルに必要なソフトウェアパッケージ。
例： python>=3.8、pandas>=1.5.0
skill.mdファイル内のメタデータは、段階的な情報開示システムの最初のレベルとして機能し、すべてのコンテンツを読み込まなくても、スキルをいつ使用すべきかをClaudeが知るのに十分な情報を提供します。
マークダウン本文
マークダウン本文はメタデータの後の詳細の2番目のレベルであるため、Claudeはメタデータを読んだ後、必要に応じてこれにアクセスします。タスクに応じて、Claudeはskill.mdファイルにアクセスしてスキルを使用できます。
skill.mdの例
ブランドガイドラインスキル
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
リソースを追加する
単一のskill.mdファイルに追加するには情報が多すぎる場合（例えば、特定のシナリオにのみ適用されるセクション）、スキルディレクトリ内にファイルを追加することで、より多くのコンテンツを追加できます。たとえば、補足情報とリファレンス情報を含むREFERENCE.mdファイルをスキルディレクトリに追加します。skill.mdでそれを参照することで、スキルを実行するときにそのリソースにアクセスする必要があるかどうかをClaudeが判断するのに役立ちます。
スクリプトを追加する
より高度なスキルの場合、実行可能なコードファイルをskill.mdに添付して、Claudeがコードを実行できるようにします。たとえば、ドキュメントスキルは以下のプログラミング言語とパッケージを使用します：
Python（pandas、numpy、matplotlib）
JavaScript/Node.js
ファイル編集を支援するパッケージ
可視化ツール
注： ClaudeおよびClaudeコードは、スキルを読み込むときに標準リポジトリ（Python PyPI、JavaScript npm）からパッケージをインストールできます。API Skillsでは実行時に追加のパッケージをインストールすることはできません。すべての依存関係はコンテナに事前にインストールされている必要があります。
スキルをパッケージ化する
スキルフォルダが完成したら：
フォルダ名がスキルの名前と一致することを確認します。
フォルダのZIPファイルを作成します。
ZIPはスキルフォルダをルートとして含める必要があります（サブフォルダではなく）。
正しい構造：
my-skill.zip
└── my-skill/
├── skill.md
└── resources/
不正な構造：
my-skill.zip
└── （ZIPルートに直接ファイル）
スキルをテストする
アップロード前
1. skill.mdを明確性について確認します。
2. 説明がClaudeがスキルを使用すべき時期を正確に反映していることを確認します。
3. 参照されているすべてのファイルが正しい場所に存在することを確認します。
4. 例のプロンプトでテストして、Claudeが適切に呼び出すことを確認します。
Claudeにアップロード後
1. カスタマイズ > スキルでスキルを有効にします。
2. それをトリガーすべき複数の異なるプロンプトを試します。
3. Claudeの思考を確認して、スキルが読み込まれていることを確認します。
4. Claudeが予想通りに使用していない場合は、説明を繰り返します。
TeamおよびEnterpriseプランのユーザーへの注： 組織内のすべてのユーザーがスキルを利用できるようにするには、組織のスキルをプロビジョニングおよび管理するを参照してください。
ベストプラクティス
焦点を絞る： 異なるワークフロー用に個別のスキルを作成します。複数の焦点を絞ったスキルは1つの大きなスキルよりも構成が優れています。
明確な説明を書く： Claudeは説明を使用してスキルを呼び出すかどうかを判断します。いつ適用されるかについて具体的に説明してください。
シンプルに始める： 複雑なスクリプトを追加する前に、マークダウンの基本的な指示から始めます。後でスキルを拡張することはいつでもできます。
例を使用する： skill.mdファイルに入力と出力の例を含めて、Claudeが成功の様子を理解するのに役立てます。
段階的にテストする： 複雑なスキルをすべて一度に構築するのではなく、重大な変更の後にテストします。
スキルは相互に構築できます： スキルは明示的に他のスキルを参照することはできませんが、Claudeは複数のスキルを自動的に一緒に使用できます。この構成可能性はスキル機能の最も強力な部分の1つです。
オープンエージェントスキル仕様を確認する： agentskills.ioのガイドラインに従って、作成するスキルが標準を採用するプラットフォーム全体で機能するようにします。
スキル作成のより詳細なガイドについては、Claude Docsのスキル作成のベストプラクティスを参照してください。
セキュリティに関する考慮事項
skill.mdファイルにスクリプトを追加する場合は注意してください。
機密情報（APIキー、パスワード）をハードコードしないでください。
ダウンロードしたスキルを有効にする前に確認してください。
外部サービスアクセスに適切なMCP接続を使用してください。
参照するスキルの例
テンプレートとして使用できるスキルの例については、GitHubのリポジトリにアクセスしてください：https://github.com/anthropics/skills/tree/main/skills。