my-new-skill

name	my-new-skill
description	One sentence that describes WHEN to invoke this skill. Write it as a trigger phrase, not a summary — include the words a user would say ("fix bug", "add feature", "review diff"). The agent routes on this field.

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)