Readability Analyzer by langbot-team

# Readability Analyzer

Flesch Reading Ease + Flesch-Kincaid grade + text stats. Pure stdlib.

```
python scripts/run.py article.txt
cat article.txt | python scripts/run.py -
python scripts/run.py article.txt --json
```

Higher Flesch Reading Ease = easier to read (0-100 scale).


---
name: text-statistics
display_name: Readability Analyzer
description: "Compute readability scores (Flesch Reading Ease, Flesch-Kincaid grade) plus word/sentence/syllable stats for a passage. Triggers: readability score, flesch reading ease, grade level, text statistics, how hard to read."
---

# Readability Analyzer

Score how readable a passage is and report basic text statistics.

## When to use
The user wants to know how hard a piece of text is to read — a Flesch Reading Ease score, Flesch-Kincaid grade level, or counts of words/sentences/syllables.

## How to use
Run `scripts/run.py` on a file or stdin:
- `python scripts/run.py article.txt` — full readability report.
- `cat article.txt | python scripts/run.py -` — read from stdin.
- `python scripts/run.py article.txt --json` — machine-readable JSON with all metrics.

Output includes character/word/sentence/syllable counts, averages, Flesch Reading Ease (0-100, higher = easier) with a band label, and the Flesch-Kincaid grade level.

## Pitfalls
- Syllable counting is a heuristic (vowel-group based); scores are estimates, best on English prose.
- Sentences are split on `.!?` — abbreviations or unusual punctuation can skew the sentence count.
- Empty input (no words) exits 1.