writing-skills
Installation
SKILL.md
Writing Skills
A skill buys predictability: the same process every run, not the same output.
Invocation
- Model-invoked — the agent, or another skill, reaches it unprompted. Paid in context load.
- User-invoked —
disable-model-invocation: true; paid in cognitive load. Once they outnumber what a human remembers, one names the rest.
Description
Triggers only — what fires the skill, rather than how it works. The skill's scarcest budget: prune it harder than the body.
- Front-load the leading word. Invocation work happens there.
- One trigger per branch. Synonyms renaming one branch are the same trigger twice: "build features using TDD … asks for test-first development".
- Identity already stated in the body stays out.