skill-creator

Skill Creator は、プロジェクトのスキル規約に従って、`SKILL.md` と `references/` の完全な構成を作成します。概念を説明するリファレンス（WHY + WHEN、各最大 150 行）と、コピーしてすぐに使えるテンプレートを分けて作成します。新しいスキルの作成、パターンに従っていないスキルの再構成、リファレンスが不足しているスキルや内容が古いスキルの改善、既存のスキルを別のフレームワークに適応させる、という 4 つのフローに対応します。各フローの最後に、スキルを所有するエージェントの frontmatter と marketplace.json に登録し、その後 `fuse-ai-pilot:sniper` で検証します。

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

Skill Creator

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

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

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、最大 150 行
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 に適切な frontmatter がある
• すべてのリファレンスが frontmatter に記載されている
• エージェントのワークフローのセクションがある
• リファレンスガイドに「概念」と「テンプレート」の表がある
• 各リファレンスが 150 行未満である
• テンプレートに完全で動作するコードがある
• エージェントと marketplace.json に登録されている

---

ベストプラクティス

DO

• 作成前に公式ドキュメントを調査する
• 整理には表を使う
• リファレンスをテンプレートにリンクする
• リファレンスは概念の説明にとどめる
• コピーしてすぐに使えるテンプレートを作成する

DON'T

• フランス語で書かない（英語のみ）
• ドキュメントをそのままコピーしない
• リファレンスを 150 行以上にしない
• 登録の手順を忘れない
• sniper による検証を省略しない