Creating Skills

A skill for creating new skills and iteratively improving them, merged from Anthropic's skill-creator and OpenAI's Codex skill-creator. Targets both Codex and Claude Code; runtime-specific extras live in references/.

The Loop

1. Decide what the skill should do, with concrete examples.
2. Plan reusable contents (scripts, references, assets).
3. Draft SKILL.md.
4. Run test prompts with-skill and (when subagents are available) baseline.
5. Review qualitatively + quantitatively, edit, repeat.
6. Validate, then optionally optimize the description.

Figure out where the user is in this loop and jump in there. If they say "vibe with me, no evals," do that. If they hand you a draft, go straight to eval/iterate.

Core Principles

Concise is key