Skill Creator

公式ドキュメント: https://code.claude.com/docs/en/skills.md。frontmatter のセマンティクス、サブエージェント フォーク、フック統合、または最新機能について不明な場合は取得してください。

プロセス

1. 要件の収集

ユーザーに以下を質問します:

• スキルが対応するタスク/ドメインは何か?
• 対応すべき具体的なユースケースは何か?
• 実行可能なスクリプトが必要か、それとも単なる指示だけか?
• 含めるべき参考資料があるか?

ユーザーの説明が既に明確な場合は、ドラフト作成に直接進みます。

2. 配置場所の決定

コンテキストから推測し、曖昧な場合のみ質問します:

• グローバル (~/.claude/skills/) - すべてのプロジェクト共通
• プロジェクト (<project>/.claude/skills/) - リポジトリ固有
• プラグイン (<plugin>/plugins/<name>/skills/) - マーケットプレイスを通じて配布

3. 複雑さの評価

シンプル (SKILL.md のみ作成):

• 純粋に指示的 (ワークフロー、ガイドライン、ドメイン知識)
• サポートファイルが不要

フル (バンドルされたリソース付きスキル):

• 決定的な/繰り返される操作のためのスクリプトが必要
• 参考資料が必要 (スキーマ、API ドキュメント、大規模ナレッジベース)
• アセットが必要 (テンプレート、画像、フォント)

4. スキルのドラフト作成

シンプルパス: ディレクトリを作成し、SKILL.md を直接作成します。

フルパス:

1. サポートファイルを計画 (必要なスクリプト/参考資料/アセット)
2. スキルディレクトリとサブディレクトリを作成
3. サポートファイルを先に作成 (アセット/ドキュメントについてはユーザー入力が必要な場合がある)
4. SKILL.md を最後に作成し、サポートファイルを参照

5. ユーザーと共にレビュー

ドラフトを提示し、反復します。スキルは実際の使用後に最も改善されます。

スキル構造

skill-name/
├── SKILL.md              # メイン指示書(必須)
├── references/           # オンデマンドでコンテキストに読み込まれるドキュメント(オプション)
│   ├── api-reference.md
│   └── schema.md
├── scripts/              # 決定的なコード(オプション)
│   └── helper.py
└── assets/               # 出力で使用されるファイル(オプション)
    └── template.html

SKILL.md からサポートファイルを参照し、Claude がそれらの存在を認識できるようにします:

- API の詳細については、[references/api-reference.md](references/api-reference.md) を参照してください
- スキーマドキュメントについては、[references/schema.md](references/schema.md) を参照してください

SKILL.md フォーマット

---
name: skill-name
description: 機能の簡潔な説明。[特定のトリガー]の場合に使用します。
---

# Skill Name

[コア指示書、ワークフロー、ガイダンス]

Frontmatter リファレンス

すべてのフィールドはオプションです。description のみ推奨されており、Claude がスキルを使用するタイミングを認識できます。

フィールド	必須	説明
name	いいえ	スキルの表示名。省略した場合、ディレクトリ名を使用します。小文字、数字、ハイフンのみ(最大 64 文字)。
description	推奨	スキルが何をし、いつ使用するか。Claude はこれを使用してスキルを適用するタイミングを判断します。省略した場合、マークダウンコンテンツの最初の段落を使用します。主要なユースケースを前置きします: description と when_to_use の結合テキストは、コンテキスト使用量を削減するため、スキル一覧では 1,536 文字で切り詰められます。
when_to_use	いいえ	Claude がスキルを呼び出すべき際の追加コンテキスト (トリガーフレーズやリクエスト例など)。description に付加され、1,536 文字の上限にカウントされます。
argument-hint	いいえ	オートコンプリート時に表示されるヒント。期待される引数を示します。例: [issue-number] または [filename] [format]。
disable-model-invocation	いいえ	Claude がこのスキルを自動的に読み込むのを防ぐには true に設定します。/name で手動トリガーするワークフロー用。デフォルト: false。
user-invocable	いいえ	/ メニューから非表示にするには false に設定します。ユーザーが直接呼び出すべきではないバックグラウンドナレッジ用。デフォルト: true。
allowed-tools	いいえ	このスキルがアクティブな場合、Claude が許可を求めずに使用できるツール。空白区切りの文字列または YAML リストを受け入れます。
model	いいえ	このスキルがアクティブな場合に使用するモデル。
effort	いいえ	このスキルがアクティブな場合の努力レベル。セッション努力レベルをオーバーライドします。デフォルト: セッションから継承。オプション: low、medium、high、xhigh、max; 利用可能なレベルはモデルに依存します。
context	いいえ	フォーク済みサブエージェント コンテキストで実行するには fork に設定します。
agent	いいえ	context: fork が設定されている場合に使用するサブエージェント タイプ。
hooks	いいえ	このスキルのライフサイクルに限定されたフック。スキルとエージェントのフックの設定フォーマットを参照。
paths	いいえ	このスキルがアクティブ化される時期を制限するグロブパターン。空白区切りの文字列または YAML リストを受け入れます。設定した場合、Claude はパターンに一致するファイルで作業している場合のみ、スキルを自動的に読み込みます。パス固有ルールと同じフォーマットを使用します。
shell	いいえ	このスキル内の !`command` および ```! ブロックに使用するシェル。bash (デフォルト) または powershell を受け入れます。powershell を設定すると、Windows 上で PowerShell 経由でインラインシェルコマンドが実行されます。CLAUDE_CODE_USE_POWERSHELL_TOOL=1 が必要。

利用可能な文字列置換

スキルはスキルコンテンツの動的値に対して文字列置換をサポートしています:

変数	説明
$ARGUMENTS	スキル呼び出し時に渡されたすべての引数。$ARGUMENTS がコンテンツに存在しない場合、引数は ARGUMENTS: <value> として付加されます。
$ARGUMENTS[N]	0 ベースのインデックスで特定の引数にアクセスします (例: 最初の引数の場合 $ARGUMENTS[0])。
$N	$ARGUMENTS[N] の短縮形 (例: 最初の引数の場合 $0、2 番目の引数の場合 $1)。
${CLAUDE_SESSION_ID}	現在のセッション ID。ログ、セッション固有ファイルの作成、またはスキル出力とセッションの相関に役立ちます。
${CLAUDE_SKILL_DIR}	スキルの SKILL.md ファイルを含むディレクトリ。プラグインスキルの場合、プラグインルートではなく、プラグイン内のスキルのサブディレクトリです。現在の作業ディレクトリに関わらず、スキルにバンドルされたスクリプトやファイルを参照するには、bash インジェクションコマンドで使用します。

さらに、!`<command>` (インライン) および ```! フェンスブロックは、Claude がそれを見る前にシェルコマンド出力をプロンプトに前処理します。

執筆ガイドライン

Description が最も重要なフィールドです。スキルを読み込むかどうかを判断する際に Claude が目にする唯一のものです。以下を含めます:

• 最初の文: スキルが何をするか
• 2 番目の文: トリガーをいつするか (キーワード、ファイルタイプ、シナリオ)
• 最大 1024 文字、3 人称

2 つのタイプのスキルコンテンツ:

• リファレンス - Claude が現在の作業に適用する知識 (慣例、パターン、ドメイン知識)。会話と並行してインラインで実行。
• タスク - 特定のアクション (デプロイ、コミット、コード生成) のステップバイステップの指示。多くの場合 disable-model-invocation: true と組み合わせられます。

本文 は以下を含むべき:

• Claude にとって明白ではない手続き知識
• アクション可能なステップを含む具体的なワークフロー
• サポートファイルへの参照 (Claude がそれらの存在を認識できるように)

SKILL.md をシンプルに保ちます。 200 行未満を目指し、ハード上限は 500。詳細資料はサポートファイルに移行。

スクリプトを追加する場合

以下の場合、scripts/ を追加します:

• 同じコードが繰り返し生成される場合
• 操作が決定的な信頼性を必要とする場合
• エラーが明示的な処理を必要とする場合

スクリプトはトークンを節約し、毎回コードを再生成するのと比べて信頼性を向上させます。

パス解決: プラグインスキルの場合、${CLAUDE_SKILL_DIR}/scripts/helper.js でスクリプトを参照してください (相対パスは解決されません)。スキルの独自ディレクトリ外のファイルを参照する場合のみ ${CLAUDE_PLUGIN_ROOT} を使用してください。グローバル/プロジェクトスキルの場合、相対パスで問題ありません。

ファイルを分割する場合

以下の場合、コンテンツを SKILL.md から分割します:

• SKILL.md が約 200 行を超える場合
• コンテンツが異なるドメインをカバーしている場合 (ドメインごとに個別ファイル)
• 高度な機能がめったに必要でない場合
• 大規模なスキーマ、API ドキュメント、またはナレッジベース

1 つの大きなリファレンスファイルより、複数の焦点を絞ったファイルを優先します。例: 1 つの reference.md に全て含めるのではなく、api-reference.md、schema.md、examples.md。

大きなファイル (>10k ワード) の場合は、Claude が効率的に検索できるよう、SKILL.md に grep パターンを含めます。

レビューチェックリスト

ドラフト作成後、以下を確認:

• Description に トリガーが含まれている (「使用場面...」)
• SKILL.md がシンプル (約 200 行未満)
• 時間に敏感な情報がない
• 具体例が含まれている (有用な場所)
• すべてのサポートファイルが SKILL.md で参照されている
• SKILL.md とサポートファイル間に重複情報がない