writing-skills
The meta-skill: how to author, edit, and verify skills, including trigger design, structure conventions, and pre-deployment testing.
Anatomy
| Parent repo | obra/superpowers |
|---|---|
| Path | skills/writing-skills |
| Trigger conditions | "Use when creating new skills, editing existing skills, or verifying skills work before deployment" |
| Instruction format | yaml-frontmatter-md |
| Required tools | file-edit |
| Reusability | universal |
| Complexity | medium |
| Ships scripts / examples / tests / boundaries | no / yes / yes / yes |
Failure modes
Meta-recursion risk is mostly theoretical; the practical failure is authors skipping the verification section it mandates.
Verdict
A format that documents how to extend itself is a format that survives. This plus anthropics' skill-creator are the two canonical authoring references.
Related skills
Blocks the agent from claiming work is complete, fixed, or passing until it has run verification commands and confirmed output. Evidence…
Forces root-cause investigation before any fix: reproduce, hypothesize one cause at a time, test the hypothesis, then patch. Bans…
Frequently asked questions
What does the writing-skills skill do?
The meta-skill: how to author, edit, and verify skills, including trigger design, structure conventions, and pre-deployment testing.
When does writing-skills trigger?
Its stated trigger: "Use when creating new skills, editing existing skills, or verifying skills work before deployment". Trigger precision is a scored reliability dimension.