RE
readability
Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.
Install
mkdir -p .claude/skills/readability && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16205" && unzip -o skill.zip -d .claude/skills/readability && rm skill.zipInstalls to .claude/skills/readability
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.149 charsno explicit “when” trigger
About this skill
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
## Readability Analysis
### Scores
| Metric | Score | Meaning |
|--------|-------|---------|
| Flesch Reading Ease | [X] | [interpretation] |
| Flesch-Kincaid Grade | [X] | [grade level] |
| Gunning Fog | [X] | [years education] |
| SMOG | [X] | [grade level] |
### Statistics
- Words: [X]
- Sentences: [X]
- Avg sentence length: [X] words
- Complex words: [X] ([Y]%)
### Target Audience
[Who can easily read this based on scores]
### Recommendations
1. [Specific suggestion]
2. [Specific suggestion]
3. [Specific suggestion]
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