スキルは、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の例
ブランドガイドラインスキル
## メタデータ
name: ブランドガイドライン
description: すべてのプレゼンテーションとドキュメントにAcme Corpのブランドガイドラインを適用する
## 概要
このスキルは、一貫性のある専門的な資料を作成するためのAcme Corpの公式ブランドガイドラインを提供します。プレゼンテーション、ドキュメント、またはマーケティング資料を作成する場合、これらの標準を適用して、すべての出力がAcmeの視覚的アイデンティティと一致することを確認してください。Claudeは、外部向けの資料を作成するか、Acme Corpを代表するドキュメントを作成する場合は常に、これらのガイドラインを参照する必要があります。
## ブランドカラー
公式ブランドカラーは以下の通りです：
- プライマリ：#FF6B35（コーラル）
- セカンダリ：#004E89（ネイビーブルー）
- アクセント：#F7B801（ゴールド）
- ニュートラル：#2E2E2E（チャコール）
## タイポグラフィ
ヘッダー：Montserrat Bold
本文：Open Sans Regular
サイズガイドライン：
- H1：32pt
- H2：24pt
- 本文：11pt
## ロゴの使用
明るい背景では常にフルカラーロゴを使用してください。暗い背景では白いロゴを使用してください。ロゴの周囲に最小0.5インチの間隔を保ってください。
## 適用する場合
以下を作成する場合、これらのガイドラインを適用してください：
- PowerPointプレゼンテーション
- 外部共有用のWordドキュメント
- マーケティング資料
- クライアント向けレポート
## リソース
ロゴファイルとフォントダウンロードについては、リソースフォルダを参照してください。
リソースの追加
単一のSkill.mdファイルに追加するには情報が多すぎる場合（例えば、特定のシナリオにのみ適用されるセクション）、スキルディレクトリ内にファイルを追加することで、より多くのコンテンツを追加できます。たとえば、補足情報と参照情報を含むREFERENCE.mdファイルをスキルディレクトリに追加します。Skill.mdでそれを参照することで、スキルを実行する際にそのリソースにアクセスする必要があるかどうかをClaudeが判断するのに役立ちます。
スクリプトの追加
より高度なスキルの場合、実行可能なコードファイルをSkill.mdに添付して、Claudeがコードを実行できるようにします。たとえば、ドキュメントスキルは以下のプログラミング言語とパッケージを使用します：
Python（pandas、numpy、matplotlib）
JavaScript/Node.js
ファイル編集を支援するパッケージ
ビジュアライゼーションツール
注： ClaudeおよびClaude Codeは、スキルを読み込む際に標準リポジトリ（Python PyPI、JavaScript npm）からパッケージをインストールできます。APIスキルでは実行時に追加のパッケージをインストールすることはできません。すべての依存関係はコンテナに事前にインストールされている必要があります。
スキルのパッケージング
スキルフォルダが完成したら：
フォルダ名がスキルの名前と一致することを確認してください。
フォルダの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つです。
オープンAgent Skills仕様を確認してください： agentskills.ioのガイドラインに従って、作成したスキルが標準を採用するプラットフォーム全体で機能するようにしてください。
スキル作成のより詳細なガイドについては、Claude Docsのスキル作成のベストプラクティスを参照してください。
セキュリティに関する考慮事項
Skill.mdファイルにスクリプトを追加する場合は注意してください。
機密情報（APIキー、パスワード）をハードコードしないでください。
ダウンロードしたスキルを有効にする前に確認してください。
外部サービスアクセスには適切なMCP接続を使用してください。
参照するスキルの例
テンプレートとして使用できるスキルの例については、GitHubのリポジトリにアクセスしてください：https://github.com/anthropics/skills/tree/main/skills。