Brief statement of the single job this skill does. (One clear job — if it does two things, split it.)
Instructions
State what to do, imperatively. The body stays in context across turns once invoked, so every line is recurring token cost — say what to do, not why.
- First step.
- Second step.
- Output format / what to return.
Notes (optional)
- Edge cases, "if the input is empty, say X", etc.
- Move long reference material to
references/and link it: see reference.md. - Reference bundled scripts portably with
${CLAUDE_SKILL_DIR}/scripts/foo.py.