readability
This skill evaluates text against multiple readability standards, computing Flesch Reading Ease, grade-level indices, and linguistic statistics to reveal how accessible your writing is. It returns interpreted scores alongside concrete suggestions for simplifying sentences, reducing complex vocabulary, and strengthening clarity.
readability analyzes text using Flesch-Kincaid, Gunning Fog, SMOG, and other standard readability metrics.
AI-generated summary based on this skill's SKILL.md
Install
humanizerai/agent-skills/readability
git clone https://github.com/humanizerai/agent-skills
cp -r agent-skills/skills/readability ~/.claude/skills/readabilitynpx skillfed install humanizerai/agent-skills/readabilityFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What readability metrics does readability analyze?
readability computes Flesch Reading Ease, Flesch-Kincaid grade level, Gunning Fog index, and SMOG readability metric alongside linguistic statistics. These standard measures reveal how accessible your writing is and what grade level your audience needs to understand it.
How do I check how readable my writing is?
readability evaluates your text against multiple readability standards, returning interpreted scores that show reading difficulty. You receive concrete suggestions for simplifying sentences, reducing complex vocabulary, and strengthening clarity so you can improve your content's accessibility.
What grade level does readability determine for my text?
readability calculates grade-level indices using established formulas like Flesch-Kincaid and Gunning Fog. These scores tell you the educational level required to understand your writing, helping you verify whether your content matches your intended audience's comprehension ability.
What specific recommendations does readability provide?
readability analyzes passive voice, sentence length, and complex vocabulary to identify clarity issues. It returns specific, actionable suggestions for simplifying your text, reducing sentence complexity, and improving word choice so readers can grasp your message more easily.
Can readability assess if my text suits my audience?
Yes. readability measures text complexity and returns grade-level assessments that let you verify your writing matches your intended audience. By comparing your readability scores against your target reader's comprehension level, you ensure appropriate content difficulty.
SKILL.md
rendered from the published skill — quoted content, verbatim
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
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/readability/SKILL.md