Skip to main content
Generalfusengine

skill-creator

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

Stars
13
Source
fusengine/agents
Updated
2026-05-17
Slug
fusengine--agents--skill-creator
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/fusengine/agents/HEAD/plugins/ai-pilot/skills/skill-creator/SKILL.md -o .claude/skills/skill-creator.md

Drops the SKILL.md into .claude/skills/skill-creator.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Skill Creator

Agent Workflow (MANDATORY)

Before ANY skill creation, use TeamCreate to spawn 3 agents:

  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, max 150 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
  • 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