readability-check
Installation
SKILL.md
Readability Check
Contents
- Quick start
- Profiles
- Workflow
- Revision moves
- Reading the five formulas together
- Run it automatically
- Guardrails
- Reference files
Related skills: slop-detector catches AI-explainer patterns, hedge-detector catches weak hedging, voice-check and strategist-voice catch voice violations. This skill catches structural unreadability — sentence length and word difficulty — which the others do not measure. Run this last, after voice and slop passes. When a score fails and splitting sentences does not fix it, use ladder-of-abstraction: it diagnoses what a failing score means and routes the fix to supplying a concrete particular rather than to swapping in vaguer words.
Quick start
Requires textstat. If missing, the script prints the install line and exits 3: