skill-creator
npx machina-cli add skill fusengine/agents/skill-creator --openclawSkill 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
Source
git clone https://github.com/fusengine/agents/blob/main/plugins/ai-pilot/skills/skill-creator/SKILL.mdView on GitHub Overview
Skill-creator helps you create new skills, restructure existing ones, and improve skill documentation. It automatically generates SKILL.md and a references folder with patterns and templates to ensure consistency and easy loading in agents.
How This Skill Works
Before you start, Skill-creator uses TeamCreate to spawn three agents for exploration, research, and documentation reference gathering: fuse-ai-pilot:explore-codebase, fuse-ai-pilot:research-expert, and mcp__context7__query-docs. After structure is prepared, it places SKILL.md from templates, populates references, registers the skill in agent and marketplace.json, and finally runs fuse-ai-pilot:sniper to validate all files.
When to Use It
- Creating a brand-new skill when a library/framework isn't documented
- Restructuring an existing skill to align with the canonical pattern
- Improving skill docs by adding missing references or updating content
- Adapting a skill from a similar framework (e.g., Next.js → React)
- Validating and finalizing the skill with sniper after creation
Quick Start
- Step 1: Research documentation with research-expert + context7/exa
- Step 2: Create structure under plugins/<agent>/skills/<name>/references/templates
- Step 3: Create SKILL.md from template, populate references/templates, register, and run sniper
Best Practices
- Keep all content in English (no other languages)
- Make SKILL.md descriptive and clearly guide readers to references/templates
- Keep references conceptual and concise (max ~150 lines)
- Use complete templates for SKILL.md and code examples
- Register in agent and marketplace.json, then run sniper for validation
Example Use Cases
- Create a new skill for a library that has no existing documentation yet
- Restructure an existing skill to follow the canonical SKILL.md pattern and structure
- Add missing references (workflow, architecture, content rules) to improve context
- Adapt a skill pattern from a similar framework, e.g., Next.js to React
- After creating or restructuring, validate with sniper to ensure loadability