tech-writing
Installation
SKILL.md
AI-consumed reference. Optimized for Claude to read during execution.
Technical Writing
Produce documents a reviewer can act on and argue with — not filled-in templates.
Evidence policy for this skill itself. Almost everything below is CONVENTION with an authoritative primary source, NOT measured efficacy. No study shows these structures produce better outcomes. The three places carrying real measurement are marked [MEASURED]. Never present convention as research-backed — that is the first thing this skill exists to stop.
Step 0 — Refuse to write blind
Run rules/core/prompt-validation.md (6-dimension gate) BEFORE writing. Below threshold → ask the
1–2 weakest dimensions, do not guess. A doc written from guesses is worse than no doc: it looks
authoritative and is wrong.