Skill Creator
Agent Workflow (MANDATORY)
Before ANY skill creation, use TeamCreate to spawn 3 agents:
- fuse-ai-pilot:explore-codebase - Check existing skills, analyze structure
- fuse-ai-pilot:research-expert - Fetch latest official documentation online
- 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
- ALL content in English - Never French or other languages
- SKILL.md is descriptive - Guides agent to references/templates
- References are conceptual - WHY + WHEN, max 150 lines
- Templates are complete - Copy-paste ready code
- Register in agent + marketplace.json - Or skill won't load
- 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
- [ ] References < 150 lines each
- [ ] 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 150 lines in references
- Forget registration step
- Skip sniper validation