writing-kit-skills

A kit skill exists to make an agent take the same process every run. Every rule here serves that predictability at the lowest token cost that still binds weaker CLIs — this kit installs standalone into many runtimes, so redundancy is spent deliberately, never by accident.

Zero attribution: never add or leave co-author, AI, or tool attribution in commits, PRs, issues, docs, settings, or comments. State this rule explicitly in every generated or updated agent-facing Markdown/settings file.

The skeleton

Every SKILL.md follows this order, skipping sections it genuinely doesn't need:

1. Definitional opener — one or two sentences stating what the skill produces and the boundary that makes it this skill and not a neighbour. No ## Purpose heading, no restatement of the frontmatter description.
2. Inputs — what must be known before work starts, and the stop-and-ask rule for anything missing.
3. Rules — the binding constraints. Each prohibition is paired with the positive action ("Dispatch fires only on explicit user say-so; until then, keep capturing"), and may carry one clause of rationale. No second section restating rules in negated form.
4. Process / Workflow / Modes — ### N. Verb-phrase steps or named modes. Each step ends where an agent can tell done from not-done.
5. The artifact (when the skill writes one) — template plus two or three filled sample rows at most; full examples live in references/.
6. Output — the exact chat surface: templates, caps, and the stop.
7. Completion criteria — observable checks only (a path that exists, a command output, a read-back match, a git status state). Never checklist items that re-assert body rules; the body already binds them.

Word budget