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
npx skills add humanizerai/agent-skills --skill word-stats -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/word-stats/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/word-stats/
1Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill word-stats -a codex2Manually: put the files in place
.agents/skills/word-stats/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill word-stats -a cursor2Manually: put the files in place
.cursor/skills/word-stats/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install humanizerai/agent-skills skills/word-stats2Manually: put the files in place
.github/skills/word-stats/SKILL.md1Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill word-stats -a gemini-cli2Platform CLI
gemini skills install https://github.com/humanizerai/agent-skills --path skills/word-statsManually: put the files in place
.devin/skills/word-stats/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add humanizerai/agent-skills --skill word-stats -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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