spec
Create, amend, or backprop bugs into SPEC.md at repo root. Sole mutator of the project spec. Triggers when the user asks to write a spec, start a new spec, distill a spec from existing code, add invariants, amend sections (§G, §C, §I, §V, §T, §B), or record a bug via backprop. Common phrasings: "write the spec for...", "new spec", "bug: ...", "amend §V.3", "distill spec from code", "spec this idea". Reads and follows FORMAT.md for the caveman encoding rules and pipe-table shape of §T and §B.
Install
Install this Claude and Codex skill with the command below. The command stays visible even when copy support is unavailable.
git clone https://github.com/JuliusBrussee/cavekit /tmp/cavekit && ln -s /tmp/cavekit/skills/spec ~/.claude/skills/specFrom README
spec — spec mutator Read FORMAT.md at repo root if not already loaded. Caveman skill applies to all writes here. DISPATCH Inspect user request and project state: No SPEC.md at repo root AND args describe idea → NEW No SPEC.md AND from-code in args → DISTILL SPEC.md exists AND args start bug: → BACKPROP SPEC.md exists AND args start amend → AMEND SPEC.md exists, no args → ask user which mode INPUTS — spec is the sole mutator The other verbs produce material; spec writes it. Ingest their handoff blocks into the right section, show a diff, write on OK: grill → sharpened §G + §C research → §R rows (add the §R section if absent) review → drafted §V lines + the risk verdict deepen → §I/§V/§T amendments ⊥ rewrite a section the handoff did not name. Sectioned ownership (see FORMAT.md). NEW — idea → spec Input: user idea. If it arrived fuzzy, prefer running grill first. Steps: Extract goal (1 line, caveman). → §G. List constraints user stated or implied. → §C.