skill-creator

name	skill-creator
description	Use when creating new skills, restructuring existing skills, or improving skill documentation. Generates SKILL.md + references/ structure with proper patterns.

Skill Creator

Agent Workflow (MANDATORY)

Before ANY skill creation, spawn 3 subagents in parallel (one dispatch, spawn_agent / MultiAgentV2):

1. explore-codebase - Check existing skills, analyze structure
2. research-expert - Fetch latest official documentation online
3. mcp__context7__query-docs - Get code examples from official sources (direct MCP call)

After creation, run 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 the agent to references/templates
3. Frontmatter = name + description ONLY - Codex skills support only these two keys
4. References are conceptual - WHY + WHEN, max 150 lines
5. Templates are complete - Copy-paste ready code
6. Register the plugin - Or the skill won't load
7. 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 the 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/<plugin>/skills/<name>/references/templates

# 3. Create files
→ SKILL.md (from template, frontmatter = name + description)
→ references/*.md (conceptual)
→ references/templates/*.md (code)

# 4. Register the plugin in the marketplace manifest

# 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 frontmatter = name + description ONLY
• Agent Workflow section present
• Reference Guide has Concepts + Templates tables
• References < 150 lines each
• Templates have complete, working code
• Plugin registered in the marketplace manifest

---

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
• Add frontmatter keys beyond name + description
• Skip sniper validation