Readability rewriter · Playbook
Readability & Plain-Language Standards — local playbook
Summary. How to act on a slowking readability rewrite — the target reading levels, the techniques that
lower a grade without losing meaning, and when a high grade is acceptable. Local fallback; point slowking at
a live Outline wiki (OUTLINE + OUTLINE_API_URL, collection via SLOWKING_WIKI_COLLECTION).
Surfaced by. slowking: the current copy’s reading grade (Flesch–Kincaid), the rewrite to the target grade, and the measured before→after.
Target reading levels
- Grade 8–12 for most B2B and consumer pages. slowking’s ideal band is 6–12; aim for 8–12 on typical marketing and informational copy.
- Exception: technical, medical, and legal pages legitimately read higher — a grade above 12 there is acceptable when accuracy demands it, not a defect to force down. slowking never FAILs on reading level; it’s guidance.
Techniques (clarity without changing meaning)
- Shorten sentences. Break 30+ word sentences into two or three. This single change lifts the grade the most.
- Plainer words. Prefer the common word over the elaborate one (“use” over “utilize”) — unless the precise term matters.
- Active voice. “The team ships the release”, not “the release is shipped by the team.”
- One idea per paragraph. Front-load the point; let the rest support it.
- Keep every fact. Numbers, names, claims, and calls to action are preserved exactly — clarity is the only thing that changes. slowking’s prompt enforces this; a reviewer should still confirm it.
Process
- slowking is output-only — it hands you
rewrite.htmlto review and paste. It never overwrites a live page (a whole-body rewrite can disturb images, embeds, CTAs, and page-builder shortcodes). - Check the measured before→after grade (graded on the same text), not just the promise. On long pages, rewrite section by section — one pass covers only the first ~12 000 characters.