home / skills / fusengine / agents / skill-creator

skill-creator skill

Q: What files will this skill produce?

It produces an entry document, a references directory of conceptual guides, and a templates folder with complete example code, plus metadata for registration.

Q: How long should each reference be?

References should be concise; aim for under 150 lines and focus on rationale, usage, and links to templates.

Q: What validation is required before publishing?

Ensure all content is English, entry document includes required frontmatter, references are listed, templates run locally, registration metadata exists, and run the final automated validation tool.

/plugins/ai-pilot/skills/skill-creator

This skill assists you create, restructure, and document skills by generating SKILL.md and references with ready-to-use templates.

npx playbooks add skill fusengine/agents --skill skill-creator

Review the files below or copy the command above to add this skill to your agents.

Files (9)

SKILL.md

4.5 KB

---
name: skill-creator
description: Use when creating new skills, restructuring existing skills, or improving skill documentation. Generates SKILL.md + references/ structure with proper patterns.
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
---

# 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](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

Overview

This skill helps authors create, restructure, and improve other skills by producing a complete skill package: entry documentation, conceptual references, and copy-paste ready templates. It enforces a consistent architecture, registration steps, and a validation workflow so new or updated skills load reliably in the agent ecosystem.

How this skill works

The skill spawns a small investigator team to audit code, fetch authoritative documentation, and extract code examples. It then generates a structured skill folder containing an entry document, a references directory with conceptual guides, and a templates folder with runnable examples. Finally, it runs validation steps and checks registration to ensure the skill is discoverable and functional.

When to use it

Creating a brand-new skill for an unlisted library or framework
Restructuring an existing skill that doesn't follow the project pattern
Updating references and templates after upstream changes
Adapting a skill from one framework to another (for example, Next.js → React)
Preparing a skill for marketplace registration and automated validation

Best practices

Always research official docs first and cite conceptual sources, not raw copies
Keep each reference concise (target <150 lines) and focused on WHY and WHEN
Provide complete, copy-paste ready templates that developers can run immediately
Use consistent folder architecture: entry doc, references/, references/templates/
Register the skill in agent metadata and marketplace files before final validation
Run an automated validation pass after creation to catch missing frontmatter or files

Example use cases

Generate a new TypeScript skill with full references and runnable examples for a specific library
Refactor a legacy skill to match current architecture and update registration metadata
Add missing conceptual guides and templates when official docs change
Convert implementation examples from one framework to another while preserving best-practice guidance
Validate that a skill is complete and ready for marketplace publishing

FAQ

What files will this skill produce?

It produces an entry document, a references directory of conceptual guides, and a templates folder with complete example code, plus metadata for registration.

How long should each reference be?

References should be concise; aim for under 150 lines and focus on rationale, usage, and links to templates.

What validation is required before publishing?

Ensure all content is English, entry document includes required frontmatter, references are listed, templates run locally, registration metadata exists, and run the final automated validation tool.