skill-forge

Skill Forge — 究極のClaude Codeスキル作成ツール

Agent Skillsオープンスタンダード、段階的開示アーキテクチャ、高い成果を上げている claude-seoやclaude-adsなどのスキルで実証済みのパターンに従って、 本番環境で使える品質のClaude Codeスキルを作成します。

クイックリファレンス

コマンド	説明
/skill-forge	対話型スキル作成ウィザード
/skill-forge plan <domain>	アーキテクチャと設計の計画
/skill-forge build <name>	計画に基づいてスキルのひな形を作成し、構築
/skill-forge review <path>	既存スキルの品質を監査
/skill-forge evolve <path>	フィードバックや問題に基づいてスキルを改善
/skill-forge eval <path>	スキルの品質をテストする評価パイプラインを実行
/skill-forge benchmark <path>	分散分析を行ってスキルをベンチマーク
/skill-forge publish <path>	配布用にパッケージ化して準備
/skill-forge convert <path>	スキルをCodex/Gemini/Antigravity/Cursor向けに変換

オーケストレーションのロジック

対話モード（/skill-forge）

スキル作成の全工程をユーザーに案内します。

1. 要件の確認：ドメイン、ユースケース、対象ユーザーについて尋ねます
2. アーキテクチャ：スキルの複雑さの段階を判断し、構造を設計します
3. 構築：選択したテンプレートに従って、すべてのファイルを生成します
4. レビュー：構造、フロントマター、トリガー、品質を検証します
5. 評価：アサーションと採点を用いて評価パイプラインを実行します
6. ベンチマーク：分散分析を行い、合格率、所要時間、トークン数を測定します
7. 反復：評価結果とフィードバックに基づいて改善します

コマンドの振り分け

特定のコマンドでは、対応するサブスキルを読み込みます。

• /skill-forge plan -> skills/skill-forge-plan/SKILL.md
• /skill-forge build -> skills/skill-forge-build/SKILL.md
• /skill-forge review -> skills/skill-forge-review/SKILL.md
• /skill-forge evolve -> skills/skill-forge-evolve/SKILL.md
• /skill-forge eval -> skills/skill-forge-eval/SKILL.md
• /skill-forge benchmark -> skills/skill-forge-benchmark/SKILL.md
• /skill-forge publish -> skills/skill-forge-publish/SKILL.md
• /skill-forge convert -> skills/skill-forge-convert/SKILL.md

スキルの複雑さの段階

ユーザーの説明に基づいて、適切な段階を判定します。

段階1：単一スキル（1つのSKILL.md）

• シンプルなワークフローまたはドキュメント生成
• サブスキルやサブエージェントは不要
• 指示は200行未満
• テンプレート：assets/templates/minimal.md

段階2：スキル＋スクリプト（SKILL.md + scripts/）

• 決定論的な実行（検証、データ処理）が必要
• 壊れやすい処理にはPython/Bashスクリプトを使用
• テンプレート：assets/templates/workflow.md

段階3：複数スキルのオーケストレーター（メインスキル＋サブスキル）

• 複数の異なるワークフローを含む複雑なドメイン
• メインスキルから専門のサブスキルに振り分け
• サブスキル間で参照を共有
• テンプレート：assets/templates/multi-skill.md

段階4：完全なエコシステム（オーケストレーター＋サブスキル＋エージェント＋スクリプト）

• サブエージェントへの並列委譲に対応するエンタープライズ品質のスキル
• 決定論的なタスクを実行する複数のスクリプト
• 業界向けテンプレートと参考知識
• テンプレート：assets/templates/ecosystem.md

コア原則（生成するすべてのスキルで徹底）

1. 段階的開示（3レベル）

• レベル1（フロントマター）：常にシステムプロンプトに含まれます。名前＋説明のみ（約50～100トークン）
• レベル2（SKILL.md本文）：有効化時に読み込まれます。中核となる指示（500行未満、5000トークン未満）
• レベル3（references/scripts/assets）：必要に応じて読み込まれます。詳細な知識と実行処理

2. 説明が要

descriptionフィールドによって、スキルを有効化するタイミングが決まります。次の内容を必ず含めます。

• スキルが何をするか（機能）
• いつ使うか（ユーザーが使うと考えられるトリガーフレーズ）
• マッチングに使う主要なドメインキーワード

完全なフレームワークについては、references/description-guide.mdを参照してください。

3. 3 層アーキテクチャ

• レイヤー 1（指示）：SKILL.md の指示、参照ファイル＝「何をするか」
• レイヤー 2（オーケストレーション）：Claude のルーティングと意思決定＝「どのようにするか」
• レイヤー 3（実行）：scripts/ 内のスクリプト＝「実行する」

決定論的な作業はスクリプトに移します。確率的な判断は指示に残します。

4. 命名規則

• スキルフォルダー：kebab-case（小文字とハイフンのみ）
• Name フィールドはフォルダー名と完全に一致させる必要があります
• サブスキル：{parent}-{child}（例：seo-audit、ads-google）
• エージェント：agents/{skill}-{role}.md（例：agents/seo-technical.md）
• スキル名に「claude」や「anthropic」を含めないでください（予約済み）

5. ファイルの規則

• 必須：SKILL.md（大文字・小文字を正確に一致させる）
• スキルフォルダー内に README.md を置かないでください
• フロントマターに XML の山括弧を使用しないでください
• 参照ファイル：目的を絞り、小さく保ち、必要に応じて読み込む
• スクリプト：単一目的で、テスト可能かつ十分なドキュメントを備える

品質ゲート

生成したスキルを完成としてマークする前に、以下を確認してください。

• 有効な YAML フロントマターを含む SKILL.md が存在する
• Name が有効な kebab-case である（1～64 文字）
• Description に WHAT + WHEN + キーワードが含まれている（1024 文字未満）
• フロントマターに XML タグがない
• 指示が具体的で実行可能である（曖昧でない）
• よくある失敗に対するエラー処理が含まれている
• 主要なワークフローの例が用意されている
• SKILL.md の本文が 500 行未満である
• 詳細な知識は本文に直接記載せず、参照ファイルにリンクされている
• スクリプトに docstring、型ヒント、エラー処理がある

python scripts/validate_skill.py <path> を実行して、プログラムで検証します。

参照ファイル

必要に応じて読み込みます。起動時にすべて読み込まないでください。

• references/anatomy.md -- スキルファイルの構成、命名規則、エージェントの形式
• references/patterns.md -- 実証済みのワークフローパターンと例
• references/frontmatter-spec.md -- YAML フロントマター仕様（スキル）
• references/description-guide.md -- トリガーに最適化された説明の書き方
• references/testing-guide.md -- テスト方法とチェックリスト
• references/pro-agent.md -- 3 層アーキテクチャの詳細
• references/tools-reference.md -- すべてのツール名、権限パターン、MCP
• references/hooks-reference.md -- フックイベント、種類、品質ゲートのパターン
• references/skills-activation.md -- スキルの検出、アクティベーション、高度な機能
• references/platforms.md -- プラットフォーム仕様と変換ルール

サブスキル

このスキルは、以下の 8 つの専門サブスキルをオーケストレーションします。

1. skill-forge-plan -- アーキテクチャ設計とユースケースの計画
2. skill-forge-build -- スキルファイルのひな形作成と生成
3. skill-forge-review -- 既存スキルの監査と検証
4. skill-forge-evolve -- フィードバックに基づくスキルの改善
5. skill-forge-eval -- アサーションと採点を含む評価パイプラインの実行
6. skill-forge-benchmark -- 分散分析によるパフォーマンスのベンチマーク
7. skill-forge-publish -- 配布用のパッケージ化と準備
8. skill-forge-convert -- Codex、Gemini CLI、Antigravity、Cursor 向けのスキル変換