← Back to Skills Marketplace
johnnywang2001

Text Stats

by John Wang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
149
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install jrv-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-...
README (SKILL.md)

Text Stats

Analyze text for word count, readability, reading time, and more. Reads files or stdin.

Quick Start

# Analyze a file
python3 scripts/text_stats.py README.md

# Multiple files
python3 scripts/text_stats.py file1.txt file2.txt

# From stdin
echo "The quick brown fox jumps over the lazy dog." | python3 scripts/text_stats.py

# JSON output
python3 scripts/text_stats.py essay.md -f json

# Compact (key metrics only)
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)
Usage Guidance
This skill appears safe and does what it claims: it analyzes text locally with a small Python script and has no network calls or credential access. Before installing/run: (1) review the included script (it's short and uses only the stdlib); (2) only supply files you are comfortable having processed locally (the script will read file contents); (3) if you obtained this skill from an unknown source and need stronger assurance, run it in a sandbox or compare the code to a trusted repository; and (4) note the syllable heuristics and sentence splitting are English-optimized and approximate.
Capability Analysis
Type: OpenClaw Skill Name: jrv-text-stats Version: 1.0.0 The skill bundle provides a standard utility for analyzing text statistics such as word count, readability scores (Flesch-Kincaid), and estimated reading time. The implementation in `scripts/text_stats.py` relies solely on the Python standard library, processes files or stdin locally, and contains no indicators of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
The name/description (text statistics, readability, reading/speaking time) match the provided SKILL.md and the included Python script. There are no unrelated required binaries, env vars, or config paths.
Instruction Scope
SKILL.md instructs running the bundled script on files or stdin and describes output flags; the runtime instructions and code operate only on supplied text and produce local output. The instructions do not request reading unrelated system files or sending data to external endpoints.
Install Mechanism
No install spec; the skill is instruction-only with an included script. Nothing is downloaded or installed from remote URLs and the script uses only the Python standard library.
Credentials
No environment variables, credentials, or config paths are required. The script reads only files you pass or stdin, which is proportionate to its stated purpose; be aware that any file you provide will be read and processed locally.
Persistence & Privilege
The skill is not declared as always:true and does not attempt to modify agent/system configuration. Autonomous invocation is allowed by default but there are no privileged actions requested by the skill.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install jrv-text-stats
  3. After installation, invoke the skill by name or use /jrv-text-stats
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of text-stats skill: - Analyze text files for word count, character count, line count, sentence count, syllables, and paragraph count. - Provides vocabulary statistics, readability scores (Flesch Reading Ease, Flesch-Kincaid Grade), and difficulty level. - Estimates reading (238 WPM) and speaking time (150 WPM). - Supports multiple files, stdin input, JSON output, and compact summary mode. - Requires only Python 3 standard library; handles UTF-8 text and encoding errors robustly.
Metadata
Slug jrv-text-stats
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Text Stats?

Analyze text files for word count, character count, line count, sentence count, reading time, speaking time, readability scores (Flesch Reading Ease, Flesch-... It is an AI Agent Skill for Claude Code / OpenClaw, with 149 downloads so far.

How do I install Text Stats?

Run "/install jrv-text-stats" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Text Stats free?

Yes, Text Stats is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Text Stats support?

Text Stats is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Text Stats?

It is built and maintained by John Wang (@johnnywang2001); the current version is v1.0.0.

💬 Comments