anthropic-skill-creator

スキルの作成

正しく起動し、安定して実行され、簡潔さを保つスキルを構築します。

基本原則

• 段階的に情報を開示します。
  • フロントマター（name、description）で起動対象を選択します。
  • SKILL.md の本文に中核となるワークフローを記述します。
  • references/ には、必要なときだけ読み込む詳細情報を置きます。
• スキルは組み合わせて使えるようにします。これが唯一の有効なスキルであるという前提は避けてください。
• 壊れやすい検証ロジックには、決定的なスクリプトを優先します。

ワークフロー

1. 具体的なユースケースを2～3個定義します。
2. 起動力の強いフロントマターを作成します。
3. 再利用可能なリソース（scripts/、references/、assets/）を設計します。
4. 実行可能な手順とエラー処理を記述します。
5. 起動テスト、機能テスト、パフォーマンステストを実施します。
6. 起動不足／過剰起動の兆候をもとに改善します。

1）ユースケースを定義する

ユースケースごとに、次の内容を記録します。

• ユーザーの表現（実際にどのように依頼するか）
• 期待する結果
• 複数ステップのワークフローと必要なツール（組み込みおよび／または MCP）
• ガードレールが必要な失敗箇所

ユースケースが曖昧な場合は、作成に入る前に、要点を絞った追加質問をしてください。

2）フロントマターの設計（最重要）

正しく起動するために必要な情報だけを記述します。

必須フィールド：

• name：ケバブケースで、フォルダー名と一致させます
• description：次の両方を含めます
  • スキルが行うこと
  • 使用する場面（起動フレーズ／コンテキスト／ファイル形式）

説明の形式：

• ［スキルが行うこと］＋［使用する場面］＋［主な機能］

良い例：

• 「契約書レビューのためにPDF形式の法的文書を処理します。PDF契約書から条項の抽出、リスクの指摘、変更履歴の要約をユーザーが依頼した場合に使用します。」

悪い例：

• 「プロジェクトを支援します。」

精度を高める方法：

• 過剰起動を減らすために、除外する起動条件を追加します。
• 該当する場合は、関連するファイル形式を明記します。
• ユースケースで使われる実際のユーザー表現に合わせます。

3）リソース計画

• scripts/：繰り返し使う決定的なチェック／変換
• references/：大容量のドキュメント、ドメインロジック、バリエーションごとのガイダンス
• assets/：出力に使用するテンプレートや成果物

ルール：

• SKILL.md は簡潔に保ち、references/ へのリンクを記載します。
• スキルフォルダーに余分なドキュメント（README.md、変更履歴など）を置かないでください。

4）指示の作成

命令形で、テスト可能な手順を書きます。

次の内容を含めます。

• 明確な手順の順序と依存関係
• 検証ポイント
• よくあるエラーと具体的な修正方法
• ユーザー入力例と期待される出力

重要なチェックには、文章だけのチェックよりスクリプトを優先します。

5）テスト手順

次の3つのテストグループを実施します。

A. 起動テスト

• 明確な依頼で起動すること
• 言い換えた依頼でも起動すること
• 関係のない依頼では起動しないこと

目標ベンチマーク：

• 10～20件のプロンプトで構成するテストスイートにおいて、関連するプロンプトの約90％で起動すること

B. 機能テスト

次を検証します。

• 出力の正確性
• ツール／API 呼び出しの成功
• エラー処理の経路
• エッジケース

C. パフォーマンス比較

スキルがある場合とない場合を比較します。

• 確認のためのやり取りの回数
• 失敗したツール／API 呼び出しの数
• トークン使用量
• エンドツーエンドの完了品質

6）改善ルール

起動不足の兆候：

• 期待どおりにスキルが読み込まれない
• ユーザーが何度も手動でスキルを呼び出す

修正方法：

• description に、より明確な起動フレーズと技術用語を追加します。

過剰起動の兆候：

• 関係のない依頼でもスキルが読み込まれる

修正方法：

• 除外する起動条件を追加し、対象範囲を絞り込みます。

実行上の問題：

• 出力の不整合、再試行、ユーザーによる修正

修正方法：

• 指示を明確化し、明示的な検証を追加して、重要なチェックをスクリプト化します。

トラブルシューティング早見表

• SKILL.md が見つからずアップロードに失敗する：ファイル名は正確に SKILL.md にする必要があります。
• フロントマターが無効：YAML の区切り文字 --- と構文が正しいことを確認してください。
• スキル名が無効：小文字のケバブケースを使用してください。
• スキルが適用されない：重要な指示を先頭に移し、具体的に記述してください。
• 動作が遅い：長い内容を references/ に移し、有効にするスキルの数を減らしてください。

スキャフォールディング

新しいスキルのディレクトリーをスキャフォールドします。

# Use default path (.agents/skills)
bash scripts/new_skill.sh <skill-name>

# Place in .claude/skills directory
bash scripts/new_skill.sh <skill-name> --path .claude/skills

参考資料

• references/checklist.md
• references/prompt-templates.md
• references/patterns.md
• references/source.md：元の PDF と抽出した原則
• references/trigger-examples.md：説明文の調整に使う、トリガー／非トリガーの例
• references/failure-remedies.md：失敗パターンと最小限の効果的な修正