Get the FREE Ultimate OpenClaw Setup Guide →

skill-creator

npx machina-cli add skill fusengine/agents/skill-creator --openclaw
Files (1)
SKILL.md
4.5 KB

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

ActionWhen to Use
New SkillLibrary/framework not yet documented
RestructureExisting skill doesn't follow pattern
ImproveMissing references or outdated content
AdaptCopy 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

TopicReferenceWhen to Consult
Workflowworkflow.mdCreating/improving skills
Architecturearchitecture.mdUnderstanding skill structure
Content Rulescontent-rules.mdWriting references/templates
Registrationregistration.mdMaking skill available
Adaptationadaptation.mdConverting between frameworks

Templates

TemplateWhen to Use
SKILL-template.mdCreating new SKILL.md
reference-template.mdCreating reference files
template-template.mdCreating 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

  1. Step 1: Research documentation with research-expert + context7/exa
  2. Step 2: Create structure under plugins/<agent>/skills/<name>/references/templates
  3. 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

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers