Readability

by humanizerai307912e3acdcNo license49 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 8 months ago

Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.

Instructions onlyWriting & Content
AI-generated overview

Analyzes text readability using Flesch-Kincaid, Gunning Fog, SMOG and other metrics, returning scores with interpretation and recommendations.

What it does
Calculates readability metrics for a supplied text, including Flesch Reading Ease, Flesch-Kincaid Grade, Gunning Fog and SMOG, plus text statistics such as word count, sentence count, average sentence length, complex word percentage and an estimate of passive voice. It presents the scores in a table with interpretations, identifies a likely target audience, and offers specific recommendations for shortening sentences or simplifying complex words.
When to use it
Use it when you have a piece of text and want an objective sense of how difficult it is to read, which grade level it matches, or which sentences and words to simplify.
Requirements
No tools, packages or credentials are required beyond the agent; the skill is instructions only and ships no scripts.

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

MetricFormulaInterpretation
Flesch Reading Ease206.835 - 1.015(words/sentences) - 84.6(syllables/words)0-100, higher = easier
Flesch-Kincaid Grade0.39(words/sentences) + 11.8(syllables/words) - 15.59US grade level
Gunning Fog Index0.4[(words/sentences) + 100(complex words/words)]Years of education
SMOG Index1.043 × √(complex words × 30/sentences) + 3.1291Grade 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]
### Recommendations1. [Specific suggestion]2. [Specific suggestion]3. [Specific suggestion]

Interpretation Guide

Flesch ScoreGradeAudience
90-1005thVery easy
80-896thEasy
70-797thFairly easy
60-698-9thStandard
50-5910-12thFairly difficult
30-49CollegeDifficult
0-29GraduateVery 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

Source and attribution

Source:humanizerai/agent-skillsinskills/readabilityat commit307912e

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Readability Agent Skill | SourceWeft