skill-creator

Skill Creator scaffolds a complete `SKILL.md` + `references/` structure following the project's skill conventions: conceptual references (WHY + WHEN, each within `FUSE_SOLID_MAX_LINES`) separated from copy-paste-ready templates. It covers four flows -- creating a brand-new skill, restructuring one that doesn't follow the pattern, improving a skill missing references or with outdated content, and adapting an existing skill to a different framework -- each ending with registration in the owning agent's frontmatter and marketplace.json, then a `fuse-ai-pilot:sniper` validation pass.

It generates the skill's structural and documentation content only, not the skill's substantive technical guidance -- that must come from research-expert + explore-codebase findings gathered before writing.

Skill Creator

Agent Workflow (MANDATORY)

Before ANY skill creation, spawn 3 agents in parallel, one Agent call each with a name:

1. fuse-ai-pilot:explore-codebase - Check existing skills, analyze structure
2. fuse-ai-pilot:research-expert - Fetch latest official documentation online
3. mcp__context7__query-docs - Get code examples from official sources

After creation, run fuse-ai-pilot:sniper for validation.

---

Overview

Action	When to Use
New Skill	Library/framework not yet documented
Restructure	Existing skill doesn't follow pattern
Improve	Missing references or outdated content
Adapt	Copy from similar skill (Next.js → React)

---

Critical Rules

1. ALL content in English - Never French or other languages
2. SKILL.md is descriptive - Guides agent to references/templates
3. References are conceptual - WHY + WHEN; keep every file within FUSE_SOLID_MAX_LINES
4. Templates are complete - Copy-paste ready code
5. Register in agent + marketplace.json - Or skill won't load
6. Run sniper after creation - Validate all files

---

Architecture

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

→ See architecture.md for details

---

Reference Guide

Concepts

Topic	Reference	When to Consult
Workflow	workflow.md	Creating/improving skills
Architecture	architecture.md	Understanding skill structure
Content Rules	content-rules.md	Writing references/templates
Registration	registration.md	Making skill available
Adaptation	adaptation.md	Converting between frameworks

Templates

Template	When to Use
SKILL-template.md	Creating new SKILL.md
reference-template.md	Creating reference files
template-template.md	Creating code templates

---

Quick Reference

Create New Skill

# 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

Improve Existing Skill

# 1. Analyze
→ explore-codebase

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

# 3. Add missing files
→ references + templates

# 4. Validate
→ sniper

---

Validation Checklist

• ALL content in English
• SKILL.md has proper frontmatter
• All references listed in frontmatter
• Agent Workflow section present
• Reference Guide has Concepts + Templates tables
• Every file within FUSE_SOLID_MAX_LINES
• Templates have complete, working code
• Registered in agent + marketplace.json

---

Best Practices

DO

• Research official docs before writing
• Use tables for organization
• Link references to templates
• Keep references conceptual
• Make templates copy-paste ready

DON'T

• Write in French (English only)
• Copy-paste raw documentation
• Exceed FUSE_SOLID_MAX_LINES in any generated file
• Forget registration step
• Skip sniper validation