| name | text-stats |
| description | Analyze text files for word count, character count, line count, sentence count, reading time, speaking time, readability scores (Flesch Reading Ease, Flesch-Kincaid Grade Level), and vocabulary statistics. Use when counting words, analyzing readability, estimating reading time, or getting text metrics for documents, essays, blog posts, or any text content. |
| allowed-tools | * |
Permission Setup Review
python scripts/_wildcard_placeholder.py is an optional setup helper for the Text Stats skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.
Text Stats
Analyze text for word count, readability, reading time, and more. Reads files or stdin.
Quick Start
python3 scripts/text_stats.py README.md
python3 scripts/text_stats.py file1.txt file2.txt
echo "The quick brown fox jumps over the lazy dog." | python3 scripts/text_stats.py
python3 scripts/text_stats.py essay.md -f json
python3 scripts/text_stats.py chapter.txt --compact
Output Metrics
| Metric | Description |
|---|
| Words | Total word count |
| Characters | Total characters (with and without spaces) |
| Lines | Total and non-blank line count |
| Sentences / Paragraphs | Count of each |
| Syllables | Estimated syllable count |
| Unique Words | Vocabulary diversity |
| Avg Word/Sentence Length | Average sizes |
| Reading Time | Estimated at 238 WPM |
| Speaking Time | Estimated at 150 WPM |
| Flesch Reading Ease | 0-100 scale (higher = easier) |
| Flesch-Kincaid Grade | US grade level equivalent |
| Difficulty | Easy / Standard / Fairly Difficult / Difficult / Very Difficult |
Options
| Flag | Description |
|---|
-f, --format | plain or json output |
--compact | Show only words, sentences, reading time, grade, difficulty |
Notes
- No external dependencies (Python 3 stdlib only)
- Handles UTF-8 text with graceful fallback for encoding errors
- Syllable counting is heuristic-based (English-optimized)
