Files
claude-engineering-plugin/plugins/compound-engineering/skills/john-voice/references/revision-checklist.md
John Lamb 698fe86ee3
Some checks failed
CI / pr-title (push) Has been cancelled
CI / test (push) Has been cancelled
Release PR / release-pr (push) Has been cancelled
Release PR / publish-cli (push) Has been cancelled
voice updates, blog publish skill
2026-04-20 20:09:08 -05:00

1.1 KiB

Revision Checklist

Run before finishing any piece. Each "yes" requires a rewrite.

Voice

  • Does any sentence use an em-dash? → Use parentheses or split the sentence.
  • Does any abstract noun carry a sentence? ("value," "conviction," "impact," "transformation") → Make it concrete or cut it.
  • Does any claim dissolve when drilled into? → Add the logic or cut the claim.
  • Does any hedge weaken without adding nuance? ("somewhat," "in some ways," "it's worth noting") → Cut it.

Structure

  • Does the opening start with an abstract thesis or definition? → Rewrite to open on a concrete scene.
  • Does the conclusion restate or summarize? → Replace with a question, quiet observation, or callback.
  • Do any paragraphs merely follow each other rather than cause each other? → Reorder or cut.

Momentum

  • Does any paragraph feel like it's trudging? → Rewrite until it moves.
  • Are there runs of similarly-structured sentences? → Break the pattern.
  • Does the last sentence of each paragraph land or pull forward? → Rewrite if it just stops.