skill-creator

Skill Creator は、プロジェクトのスキル規約に従って、完全な `SKILL.md` と `references/` 構成を作成します。概念的なリファレンス（WHY + WHEN。それぞれ `FUSE_SOLID_MAX_LINES` 以内）と、そのままコピー＆ペーストできるテンプレートを分けて作成します。新しいスキルの作成、パターンに従っていないスキルの再構成、リファレンスが不足している、または内容が古いスキルの改善、既存のスキルの別フレームワークへの適応という4つのフローに対応します。各フローの最後に、担当エージェントのフロントマターと marketplace.json に登録し、`fuse-ai-pilot:sniper` で検証します。

スキルの構造とドキュメントの内容のみを生成し、スキルに必要な実質的な技術ガイダンスは生成しません。技術ガイダンスは、作成前に収集した research-expert と explore-codebase の調査結果に基づいて作成する必要があります。

Skill Creator

エージェントのワークフロー（必須）

スキルを作成する前に、必ず3つのエージェントを並行して起動します。それぞれ name を指定した Agent 呼び出しを1回ずつ実行します。

1. fuse-ai-pilot:explore-codebase - 既存のスキルを確認し、構造を分析します
2. fuse-ai-pilot:research-expert - 最新の公式ドキュメントをオンラインで取得します
3. mcp__context7__query-docs - 公式ソースからコード例を取得します

作成後、検証のために fuse-ai-pilot:sniper を実行します。

---

概要

アクション	使用するタイミング
新規スキル	ライブラリ／フレームワークがまだ文書化されていない場合
再構成	既存のスキルがパターンに従っていない場合
改善	リファレンスが不足している、または内容が古い場合
適応	類似のスキルからコピーする場合（Next.js → React）

---

重要なルール

1. すべての内容を英語で記述 - フランス語やその他の言語は使用しません
2. SKILL.md は説明的な内容にする - エージェントをリファレンス／テンプレートに案内します
3. リファレンスは概念的な内容にする - WHY + WHEN を説明し、すべてのファイルを FUSE_SOLID_MAX_LINES 以内に収めます
4. テンプレートは完全な内容にする - コピー＆ペーストして使用できるコードを記載します
5. エージェントと marketplace.json に登録する - 登録しないとスキルを読み込めません
6. 作成後に sniper を実行する - すべてのファイルを検証します

---

アーキテクチャ

skills/<skill-name>/
├── SKILL.md                    # Entry point (guides agent)
└── references/                 # All documentation
    ├── installation.md         # Setup, configuration (conceptual)
    ├── patterns.md             # Core patterns (conceptual)
    ├── ...                     # Other references
    └── templates/              # Complete code examples
        ├── basic-setup.md      # Full project setup
        └── feature-example.md  # Feature implementation

→ 詳細は architecture.md を参照してください

---

リファレンスガイド

概念

トピック	リファレンス	参照するタイミング
ワークフロー	workflow.md	スキルを作成／改善する場合
アーキテクチャ	architecture.md	スキルの構造を理解する場合
コンテンツのルール	content-rules.md	リファレンス／テンプレートを作成する場合
登録	registration.md	スキルを利用可能にする場合
適応	adaptation.md	フレームワーク間で変換する場合

テンプレート

テンプレート	使用するタイミング
SKILL-template.md	新しい SKILL.md を作成する場合
reference-template.md	リファレンスファイルを作成する場合
template-template.md	コードテンプレートを作成する場合

---

クイックリファレンス

新しいスキルを作成する

# 1. Research documentation
→ research-expert + context7/exa

# 2. Create structure
mkdir -p plugins/<agent>/skills/<name>/references/templates

# 3. Create files
→ SKILL.md (from template)
→ references/*.md (conceptual)
→ references/templates/*.md (code)

# 4. Register
→ agent frontmatter + marketplace.json

# 5. Validate
→ sniper

既存のスキルを改善する

# 1. Analyze
→ explore-codebase

# 2. Research updates
→ research-expert (latest docs)

# 3. Add missing files
→ references + templates

# 4. Validate
→ sniper

---

検証チェックリスト

• すべての内容が英語である
• SKILL.md に適切なフロントマターがある
• すべてのリファレンスがフロントマターに記載されている
• 「エージェントのワークフロー」セクションがある
• リファレンスガイドに「概念」と「テンプレート」の表がある
• すべてのファイルが FUSE_SOLID_MAX_LINES 以内である
• テンプレートに完全で動作するコードがある
• エージェントと marketplace.json に登録されている

---

ベストプラクティス

推奨事項

• 作成前に公式ドキュメントを調査する
• 整理には表を使用する
• リファレンスからテンプレートにリンクする
• リファレンスは概念的な内容にする
• テンプレートはコピー＆ペーストして使えるようにする

禁止事項

• フランス語で記述する（英語のみ）
• ドキュメントをそのままコピー＆ペーストする
• 生成するファイルで FUSE_SOLID_MAX_LINES を超える
• 登録手順を忘れる
• sniper による検証を省略する