skill-creator

A skill is a folder with a SKILL.md (YAML frontmatter plus Markdown body) and optional scripts/, references/, and assets/. This skill handles the mechanics. How to write the content is a separate concern: read the writing-for-agents skill before drafting the body or the description, and treat it as the source of truth on wording.

Before creating

Ask whether the skill should exist. Each model-invoked skill adds its description to the model's context on every turn, and a crowded roster makes every skill harder to pick. Prefer one of these when it fits: a line in AGENTS.md, a plain doc reached by a pointer, or an existing skill extended with one branch. Creating a skill that overlaps an existing one, or overwriting one with the same name, needs the user's say-so.

A skill earns its place for a workflow the model needs only on certain tasks, or for instructions on using a tool or plugin, and only when its content is particular to the user, team, or product: general practice the model already holds needs no skill.

Create

1. Scaffold: python3 scripts/init_skill.py <skill-name> --path <output-directory>.
2. Frontmatter: field rules and examples in Technical rules. The description states what the skill does in a few words, then one trigger per distinct branch. Shorter is better; the 1024-character limit is a ceiling, not a target.
3. Body: for a single workflow, the steps and their completion criteria. For several workflows, a minimal router pointing to references/ files so a run reads only what its branch needs. Either way the body carries a finish line, named stops, explicit authorization for safe local actions, and user precedence, and leaves routine choices to the model (writing-for-agents, Boundaries and autonomy).
4. Bundle in scripts/ code that would otherwise be rewritten each run or must be deterministic, and give it an interface that explains itself (named flags, enumerated values, --help) so the body names the script rather than scripting its use; in assets/ templates used in output.
5. Validate: python3 scripts/quick_validate.py <skill-folder>. Package for distribution: python3 scripts/package_skill.py <skill-folder> [output-directory].

Update