git:20260729.3b91eed to git:20260904.5f1d30f

---

name: skill-creator

description: Use when creating new skills, restructuring existing skills, or improving skill documentation.

versions:

claude-plugins: "1.35"

user-invocable: true

references: references/workflow.md, references/architecture.md, references/content-rules.md, references/registration.md, references/adaptation.md, references/templates/SKILL-template.md, references/templates/reference-template.md, references/templates/template-template.md

related-skills: research, exploration

---

<objective>

Skill Creator scaffolds a complete `SKILL.md` + `references/` structure following the project's skill conventions: conceptual references (WHY + WHEN, max 150 lines each) 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.

</objective>

# Skill Creator

## Agent Workflow (MANDATORY)

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](references/architecture.md) for details

---

## Reference Guide

### Concepts

| Topic | Reference | When to Consult |

|-------|-----------|-----------------|

| **Workflow** | [workflow.md](references/workflow.md) | Creating/improving skills |

| **Architecture** | [architecture.md](references/architecture.md) | Understanding skill structure |

| **Content Rules** | [content-rules.md](references/content-rules.md) | Writing references/templates |

| **Registration** | [registration.md](references/registration.md) | Making skill available |

| **Adaptation** | [adaptation.md](references/adaptation.md) | Converting between frameworks |

### Templates

| Template | When to Use |

|----------|-------------|

| [SKILL-template.md](references/templates/SKILL-template.md) | Creating new SKILL.md |

| [reference-template.md](references/templates/reference-template.md) | Creating reference files |

| [template-template.md](references/templates/template-template.md) | Creating code templates |

---

## Quick Reference

### Create New Skill

```bash

# 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

```bash

# 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