Agent skill · writing content · aiskillstore
readability
Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.
Why this skill is useful
Provides specific metrics and recommendations for text readability that the AI wouldn't reliably generate on its own.
What it needs
About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Analyze Readability Calculate and display readability metrics for the provided text. Input The user provides text in $ARGUMENTS. If no text provided, ask for it. Metrics to Calculate Core Scores Metric Formula Interpretation -------- --------- ---------------- Flesch Reading Ease 206.835 - 1.015(words/sentences) - 84.6(syllables/words) 0-100, higher = easier Flesch-Kincaid Grade 0.39(words/sentences) + 11.8(syllables/words) - 15.59 US grade level Gunning Fog Index 0.4[(words/sentences) + 100(complex words/words)] Years of education SMOG Index 1.043 × √(complex words × 30/sentences) + 3.1291 Grade level Complex words = 3+ syllables Text Statistics Word count Sentence count Average sentence length (words) Average word length (characters) Complex words count and % Passive voice sentences (estimate) Output Format Interpretation Guide Flesch Score Grade Audience -------------- ------- ---------- 90-100 5th Very easy 80-89 6th Easy 70-79 7th Fairly easy 60-69 8-9th Standard 50-59 10-12th Fairly difficult 30-49 College Difficult 0-29 Graduate Very difficult Recommendations Based on scores, suggest: Sentences to shorten (if avg > 20 words) Complex words to simplify Passive voice to convert to active Specific examples of what to fix
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/readability