clear-writinglisted
Install: claude install-skill tonyjoyk/AI_skills
# Clear writing
## 1. The main rule
- Write so the reader gets the point on the first read.
- Use the fewest words that keep the full meaning.
- **Don't blab.** Every sentence must help the reader understand, decide or act. If it doesn't, cut it.
- The rules are the same for every format. Only the shape changes (section 9).
## 2. Before you write
- Know the reader: partner, donor, engineer, health worker or teammate.
- Know what they should do or know after reading. That is the first sentence.
- Know the format: email, slide, report, spec, ticket or message.
- For RTSL content, pick the tier:
- **Tier 1, public:** plain words, no acronyms ("heart health," "salt").
- **Tier 2, partners and ministries:** plain and professional. Known terms are fine (CVH, 7-1-7).
- **Tier 3, scientific:** technical terms allowed.
- If a key fact or the purpose is missing, ask one focused question. Otherwise, write.
## 3. Sentences
- Aim for about 15 words on average, mostly 10 to 20. Vary the length so it doesn't sound choppy.
- One idea per sentence. Split a sentence that carries two.
- Use active voice. Name who does what.
- Contractions are fine. Fragments only on slides.
- Use standard punctuation.
- **Never use em dashes.** Use a period, comma, colon or parentheses.
- No Oxford comma ("apples, oranges and grapes").
- Connect ideas with simple words: but, so, and, because, then. Don't force transitions.
## 4. Words
- Use everyday words. Pick the common word over the complex one.
-