Adapted from David Ondrej's effective-agent-skills at commit 41cb3f03deb34567cd0d3d5eae016e6408cce1fa (MIT). Recurring-correction enforcement is adapted from Cursor's poteto-mode at commit 93b00b89ef425a9c1bac0d0b317dfc49c930ac99 (MIT, Copyright (c) 2026 Cursor).

Effective Agent Skills

Workflow

1. Define one coherent capability or discipline.
2. Write the description first: capability and concrete triggers in one or two short sentences, important terms first. Add a boundary only to distinguish nearby skills; keep workflow steps in the body.
3. Keep the ordinary execution path, safety gates, output contract, and verification loop in SKILL.md.
4. Move uncommon detail into directly linked references/; put fragile or repetitive logic in tested scripts/.
5. Test positive triggers, near-miss negatives, explicit invocation, execution, failure handling, and links.

Read the authoring guide for anatomy, design patterns, composition, security, and detailed examples.

Rules