- Prefer small, composable skills over a single "mega-skill".
- Keep
SKILL.mdbodies short; move depth intoreferences/. - Bundle deterministic checks as scripts when reliability matters.
- Treat upstream docs as canonical; store agent-first checklists and decision trees.
- Every new skill must include at least one eval scenario under
eval/scenarios/.