My New Skill
Without this skill, the agent tends to . This skill enforces .
Steps
Red flags — STOP
| Thought | Reality |
|---|---|
| "I've done this before, I don't need the checklist" | Skills evolve; re-read the current SKILL.md. |
| "This case is simple" | Simple cases become complex mid-task. |
| "The user didn't ask for this rigor" | The user asked for a working result. Rigor is how you get one. |
Evidence
Every skill ships with a real before/after pair proving it changes agent behaviour on a concrete task. Without this, the skill is a claim, not a tool.
evidence/before.md— a verbatim snippet of what the agent does on a representative task WITHOUT this skill loaded. Include the prompt, the agent's response, and what went wrong (or what got skipped).evidence/after.md— the same prompt with this skill loaded. Show the changed behaviour and why it is better.
If you cannot produce a before/after pair, the skill is not ready to ship. Land it as a draft in a branch, gather the evidence, then merge.
References
references/<topic>.md(only if needed; keep the body lightweight)