write-a-skill
Installation
SKILL.md
Writing Skills
A skill exists to wrangle determinism out of a stochastic system. Predictability — the agent taking the same process every run, not producing the same output — is the root virtue; every rule below serves it. When a drafted skill misbehaves, diagnose it against the failure modes in principles.md.
Principles adapted from writing-great-skills in mattpocock/skills.
Process
-
Gather requirements — done when each of these has an answer:
- What task/domain does the skill cover, and which distinct use cases (branches) must it handle?
- Model-invoked or user-invoked? (see Invocation)
- Does it need executable scripts or just instructions?
- Any reference materials to include?
-
Draft the skill — done when the draft passes every item on the Review Checklist:
- SKILL.md with concise instructions
- Disclosed reference files for material only some branches need
- Utility scripts if deterministic operations are needed