スキルは、無料、Pro、Max、Team、およびEnterpriseプランのユーザーが利用できます。この機能にはコード実行を有効にすることが必要です。スキルはClaudeコードユーザーおよびコード実行ツールを使用するすべてのAPIユーザーのベータ版でも利用可能です。
カスタムスキルを使用すると、組織または個人の作業スタイルに固有の専門知識とワークフローでClaudeを強化できます。この記事では、独自のスキルを作成、構造化、テストする方法について説明します。
スキルは数行の指示のようにシンプルなものから、実行可能なコードを含むマルチファイルパッケージのように複雑なものまで様々です。最高のスキルは以下の特徴があります：
特定の反復可能なタスクを解決する
Claudeが従うことができる明確な指示を持つ
役立つ場合は例を含める
使用すべき時期を定義する
1つのワークフローに焦点を当てており、すべてを行おうとしない
skill.mdファイルを作成する
すべてのスキルは、最低限skill.mdファイルを含むディレクトリで構成されます。このファイルはスキルのコアです。このファイルは、必須メタデータである名前と説明フィールドを保持するYAMLフロントマターで始まる必要があります。また、追加のメタデータ、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が予想されたときにそれを使用していない場合は、説明を反復処理します。
Claudeとのチャットでスキルを反復処理する場合、スキルファイルを会話の横に開いている場所で直接編集できます。変更したいテキストをハイライトして、「Claudeで編集」をクリックし、リクエストを入力します。複数のファイルを持つスキルの場合、ファイル全体に編集リクエストを残して一緒に送信すると、Claudeは1回のパスでそれらを適用します。アーティファクトの編集について詳しく学びます。
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。