readability

SKILL.md

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
Weekly Installs
38
GitHub Stars
6
First Seen
Feb 6, 2026
Installed on
gemini-cli33
codex32
opencode32
cursor31
kimi-cli30
github-copilot30