docs: optimize skill files — dedup prose, add TOCs, sync SPEC mirrors

[sahil-noon]

Summary

Batch /internal-skill-optimize pass over src/kit/skills/ — condenses skill files by removing prose that re-explains concepts already owned by the shared _*.md partials, adds table-of-contents blocks to long files, and keeps every docs/specs/skills/SPEC-*.md mirror in sync per the constitution's SPEC-mirror rule. All edits are behavior-preserving: every behavioral step, error case, command invocation, and STOP string survives — fewer words for the same logic.

Changes

• Content trims (16 skills ≥80 lines): replaced re-explanation of partial-owned concepts (SRAD, subagent dispatch, per-stage model resolution, intake/plan generation, review dispatch, pipeline bracket) with brief references; collapsed duplicated restatements to one canonical statement; deduped redundant error-table and argument rows; consolidated repeated output blocks while preserving every literal message string. The 7 lean skills (<80 lines) were left untouched.
• Table-of-contents (33 files): added a ## Contents block to every skill and partial over 100 lines (placement: H1 → _preamble blockquote → ## Contents → first section; headings listed verbatim). Includes git-branch and the single-section _intake per the mechanical >100-line rule. All 33 TOCs verified (fence-aware) to match their real ## headings.
• SPEC mirrors (23 files, verify-then-touch): each edited skill's SPEC-*.md received a dated (260620-skop) prose-optimization annotation; the 5 SPEC files over 100 lines also received ## Contents blocks. No SPEC behavior sections (Summary/Flow/Tools/Sub-agents) changed — the edits are behavior-preserving.

Notes

• src/kit/skills/_cli-fab.md and _cli-external.md have no SPEC mirror (SPEC-_cli-fab.md / SPEC-_cli-external.md don't exist). TOCs were added to those two partials with no SPEC to update — a pre-existing gap, not introduced here.
• Most files grew in line count: the mandatory TOCs (8–23 lines each) outweigh the prose trims, though word counts dropped across the board.

🤖 Generated with Claude Code