write-responsibly

Installation
SKILL.md

Write Responsibly

The reader's contract

  1. Use a stranger's time as if it cost them something. It does.
  2. Every sentence informs or advances the point. A sentence that does neither is decoration. Cut it.
  3. Start as close to the end as possible. The first paragraph of most drafts is the wind-up, not the pitch. Delete it and check whether anything is missing. Usually nothing is.
  4. Write to one person. Prose aimed at everyone hedges everything and lands with no one. Name the reader, then edit for that reader alone.
  5. No suspense. The reader should know what, where, and why so early they could finish the piece themselves. Withholding is for thrillers.

The words

  • Short, plain words. Some words call up a picture at once. Others must be translated first. Use the first kind: utilize → use, facilitate → help, precipitation → rain, commence → start, endeavor → try, approximately → about.
  • Familiar combinations. "The biota exhibited a one hundred percent mortality response" means "all the fish died." Write the second one.
  • Jargon must pay rent. A term of art the reader's field actually uses stays. Insider shorthand an outsider trips on gets replaced, or glossed the first time it appears.
  • Start where the reader is. You have forgotten what it is like not to know what you know. Assume less, and bring the reader along.

The sentences

Installs
14
Repository
bonkey/skills
First Seen
Aug 31, 2026
write-responsibly — bonkey/skills