readability
Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.
How do I install this agent skill?
npx skills add https://github.com/humanizerai/agent-skills --skill readabilityIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill acts as a text readability calculator and analyzer. It takes text inputs and computes readability metrics like Flesch Reading Ease and Flesch-Kincaid Grade level. No security risks or harmful behaviors were identified during analysis.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/humanizerai/agent-skills/readability">View readability on skillZs</a>