# Text Stats

> Analyze text documents for word count, reading time, readability scores (Flesch-Kincaid, Gunning Fog), keyword density, and sentence statistics. Supports multiple languages including CJK. Zero dependencies.

- Skill: `dvcrn/text-stats` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/text-stats`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/text-stats/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/text-stats

---


# Text Stats

Analyze any text document for readability, word count, keyword density, and more. Perfect for content optimization, SEO analysis, or writing improvement.

## Usage

### Full analysis
```bash
python3 {baseDir}/scripts/text_stats.py analyze document.txt
python3 {baseDir}/scripts/text_stats.py analyze document.md
```

### Word count only
```bash
python3 {baseDir}/scripts/text_stats.py wc document.txt
```

### Keyword density
```bash
python3 {baseDir}/scripts/text_stats.py keywords document.txt --top 20
```

### Reading time
```bash
python3 {baseDir}/scripts/text_stats.py time document.txt
```

## Output Example

```
📊 Text Analysis: article.md
━━━━━━━━━━━━━━━━━━━━━━━━━━
Words:          2,847
Characters:     16,203
Sentences:      142
Paragraphs:     38
Avg words/sent: 20.0
Reading time:   ~11 min (at 250 wpm)

Readability:
  Flesch-Kincaid Grade: 8.2 (8th grade)
  Flesch Reading Ease:  62.1 (Standard)
  Gunning Fog Index:    10.4

Top Keywords:
  AI (47x, 1.65%)
  agent (31x, 1.09%)
  data (28x, 0.98%)
```

## Features

- 📏 Word, character, sentence, paragraph counts
- ⏱️ Estimated reading time
- 📖 Readability scores (Flesch-Kincaid, Gunning Fog, Flesch Reading Ease)
- 🔑 Keyword frequency and density
- 🇨🇳 CJK character counting (Chinese characters = words)
- 🪶 Zero dependencies — Python stdlib only

## Dependencies

None! Uses only Python standard library.