Skip to main content
skill CX Codex

word-stats — Claude Code skill: what it does, how to install

word-stats computes word counts, character counts, and reading time without followup questions. Returns text metrics formatted as Markdown tables.

MIT 517 installs ★ 58 updated 2026-02-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add humanizerai/agent-skills --skill word-stats -a claude-code
Open on GitHub

What word-stats does

This skill accepts text through command arguments and outputs Markdown tables with raw counts. It calculates words, characters with and without spaces, sentences, paragraphs, and distinct word proportions.

Calculations follow set rules: reading time divides word count by 238, while speaking pace divides by 150. The prompt forbids commentary or style advice unless requested. A missing argument stops the tool from producing metrics.

What it helps with

  • count characters with and without spaces for publication limits
  • estimate speech duration for a script or presentation
  • check distinct word ratios in an article draft
  • inspect sentence lengths across long copy

Example prompts for the agent

  • Analyze word stats for this draft: [insert text]
  • Calculate speaking time for my presentation: [speech text]
  • word-stats [text to inspect]

How to install word-stats

1Skills CLI (Vercel)

npx skills add humanizerai/agent-skills --skill word-stats -a claude-code

2Manually: put the files in place

~/.claude/skills/word-stats/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/word-stats/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about word-stats

How do I install word-stats in Claude Code?

Run npx skills add humanizerai/agent-skills --skill word-stats -a claude-code in your terminal.

What does word-stats do?

It takes your text and prints structured Markdown tables with counts, sentence metrics, and pacing estimates.

How are reading and speaking durations calculated?

The skill divides word totals by 238 for silent reading and by 150 for spoken delivery.

Source text

SKILL.md · MIT
---
name: word-stats
description: Get word count, character count, reading time, and text statistics. Quick analysis without questions.
user-invocable: true
argument-hint: "[text to analyze]"
---

# Word Statistics

Provide quick, accurate statistics about the provided text.

## Input

The user provides text in $ARGUMENTS.

**Important:** If text is provided, immediately output stats. Don't ask clarifying questions - they want the numbers.

## Output Format

```
## Word Statistics

### Counts
| Metric | Value |
|--------|-------|
| Words | [X] |
| Characters (with spaces) | [X] |
| Characters (no spaces) | [X] |
| Sentences | [X] |
| Paragraphs | [X] |

### Time
| Metric | Value |
|--------|-------|
| Reading time | [X] min |
| Speaking time | [X] min |

### Words
| Metric | Value |
|--------|-------|
| Unique words | [X] ([Y]%) |
| Avg word length | [X] chars |
| Longest word | [word] ([X] chars) |

### Sentences
| Metric | Value |
|--------|-------|
| Avg length | [X] words |
| Longest | [X] words |
| Shortest | [X] words |
```

## Calculations

- **Reading time**: words ÷ 238 (average adult reading speed)
- **Speaking time**: words ÷ 150 (average speaking pace)
- **Unique words**: distinct words ÷ total words × 100

## Keep It Simple

- Tables for metrics
- No unnecessary prose
- No recommendations unless asked
- Just the numbers

© humanizerai · MIT · humanizerai/agent-skills

Similar skills

All skills for Writing and docs →

From the same set6

Project sponsors

Companies that keep this analytics open