readability-check
Readability check
Run a readability audit on a blog post draft or other multi-paragraph prose. Use when the user asks to check readability ("check readability", "readability pass", "is this readable"), or proactively after a substantial draft is complete — as a second pass after the blog-drafting skill's critical read, not during active drafting.
For short strings — page titles, meta descriptions, schema description fields, FAQ answers, profile bios, repo taglines — use the metadata-check skill. Flesch scoring and the nine-category rubric below don't fit a 5–30 word string and will mislead.
Audience calibration
Always assume the reader reads English as a second language. That's the default, not a fallback.
In technical posts, the technical sections can use domain terms the audience expects — but any non-technical paragraph (introduction, context, conclusion, transitions, examples, analogies) must be readable by a non-technical L2 reader. Setup and motivation paragraphs carry the post for readers who don't know the domain yet; they're where you lose people.
What to check
Read the full post, then report on each criterion below. For every issue, quote the specific text, reference its location (section heading or "intro" / "conclusion"), explain the problem, and suggest a concrete fix.