← ClaudeAtlas

clear-writinglisted

Write, edit, tighten or review any work text in a plain, direct style with RTSL house rules built in: emails, Slack, slides, reports, proposals, specs, Jira tickets and product copy.
tonyjoyk/AI_skills · ★ 0 · AI & Automation · score 65
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. -