skill-creator

Skill Creator

A skill for creating new skills and iteratively improving them.

At a high level, the process of creating a skill goes like this:

• Decide what the skill should do and roughly how it should do it
• Write a draft of the skill
• Create a few test prompts and run them with the skill (spawn subagents)
• Evaluate the results both qualitatively and quantitatively
  • Draft quantitative assertions and grade the outputs
  • Compare with-skill vs baseline (without-skill) results
• Rewrite the skill based on what went wrong
• Repeat until the skill consistently improves outputs over baseline
• Expand the test set and try again at larger scale

This is a fully autonomous workflow — make all decisions yourself, do not wait for or request human feedback at any step. Proceed through the full draft → test → grade → improve → retest loop without stopping.

---

Creating a skill

Capture Intent

Analyze the task description to determine:

1. What should this skill enable Claude to do?
2. When should this skill trigger? (what contexts)
3. What's the expected output format?
4. What are the key domain constraints and edge cases?

Research

Examine the input files, data formats, and any domain-specific requirements. Understand the task deeply before writing the skill.

Write the SKILL.md

Fill in these components:

• name: Skill identifier
• description: When to trigger, what it does. This is the primary triggering mechanism - include both what the skill does AND specific contexts for when to use it. Make descriptions comprehensive — include all relevant use cases.
• compatibility: Required tools, dependencies (optional, rarely needed)
• the rest of the skill

Skill Writing Guide

Anatomy of a Skill

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description required)
│   └── Markdown instructions
└── Bundled Resources (optional)
    ├── scripts/    - Executable code for deterministic/repetitive tasks
    ├── references/ - Docs loaded into context as needed
    └── assets/     - Files used in output (templates, icons, fonts)