← ClaudeAtlas

clear-writinglisted

Use when writing a proposal, memo, report, pitch, important email, doc, essay, or a request for approval or budget. Also use when a draft feels unclear, wanders, or nobody acts on it. Not for ad, sales page, or landing copy (use conversion-copy). Not for matching a brand's tone (use brand-voice).
whoiscarlo/agent-skills · ★ 1 · Data & Documents · score 64
Install: claude install-skill whoiscarlo/agent-skills
# Clear Writing ## Overview Business writing must change what a specific reader thinks or does. Larry McEnerney's point: readers do not value what you know. They value writing that shows them a problem they care about, then helps with it. And "readers get to decide, not writers" what counts as valuable. Weak drafts explain the topic in the order the writer learned it, and never say why it matters to this reader. ## The Value Test Check the opening for McEnerney's three parts of a problem: 1. **Instability.** Something is wrong, inconsistent, missing, unresolved, or in conflict. 2. **Cost to the reader.** What leaving it alone costs *this reader*, or what fixing it gains them. Not your cost. "Why should the reader care about your costs?" 3. **A specific reader.** Not "stakeholders". "The CFO, who signs off on Q3 spend." Two checks: - **Problem words.** Does the opening contain "but", "however", "inconsistent", "risk", "missing", "cost"? McEnerney shows two versions of one abstract. The first lists facts. The second adds "Nonetheless", "However" and "anomaly", and only it creates a reason to read. No problem words usually means you wrote background. - **World problem or reader problem?** "Churn is rising across the industry" lives in the world. "Renewals fell 8 points, and your Q4 target assumed they would hold" lives in the reader. A world problem can hook. It cannot replace the reader's problem. Background (history, definitions, method) makes the reader feel settled.