writing-revise
Revise a draft's substance against critique findings or a brief — structural and argumentative changes with a change log, meaning changed deliberately. Use when the user wants restructuring, a differe
SKILL.mdskills/writing/writing-revise/SKILL.md
GitHubRevise
Change the substance while holding the commitments fixed. Where
writing-edit touches sentences with meaning fixed, this touches meaning and
shows its work.
- Establish the target. The
writing-critiquefindings, or the user's brief. If neither exists and the change is structural, runwriting-critiquefirst — revision without a diagnosis degenerates into taste-based rewriting, and the user loses the thread of why anything moved. - Inventory the commitments before touching anything: facts, numbers, names, exact terms, promises to the reader, qualifiers, the audience, and — for fiction — established canon in the bible (facts, timeline, voice tells, who-knows-what). These are protected; a revision may not quietly change them. Inventing a fact to bridge a gap is the one unforgivable revision.
- Revise from the top down: spine, then structure and scene order, then paragraphs, then sentences. A lower-tier fix is wasted when a higher-tier change relocates it — fix the spine, then re-read, then the next tier.
- Surface conflicts, never bridge them. When a needed fix would change a commitment, remove a condition, or require material you don't have, stop and present the conflict with its tradeoff. Never invent a fact, source, or scene to bridge a gap; a new scene or section is proposed, not smuggled.
- Re-read the file from disk before each write. Edit in place; never overwrite text the user has changed. If the user edited a passage since you read it, their edit outranks the plan — re-plan around it.
- Return a change log keyed to the findings or brief: what moved, what was cut, what was added, and any commitment renegotiated. A revision the user cannot audit is a revision they cannot trust.
Handoffs: line polish afterwards is writing-edit; new material that changes
the canon goes through writing-bible so the ledger stays true.