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