readability

name	readability
description	Analyze text readability with Flesch-Kincaid, Gunning Fog, SMOG, and other metrics. Returns objective scores with interpretation and recommendations.
user-invocable	true
argument-hint	[text to analyze]

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