Text Stats

Analyze text documents for word count, reading time, readability scores (Flesch-Kincaid, Gunning Fog), keyword density, and sentence statistics. Supports mul...

Security Scan

The skill's code and runtime instructions match its description: it runs a local Python script to analyze a user-specified text file, requests no credentials, and performs no network or unexpected I/O.

Purpose & Capability

The name/description (text analysis, readability, keyword density, CJK support) align with the included script and SKILL.md usage examples. The script implements the advertised features and does not request unrelated capabilities or credentials.

Instruction Scope

Runtime instructions tell the agent to execute the bundled Python script against a file path provided by the user. The script reads whatever file path is supplied (expected for a text-analyzing tool). It does not access environment variables, network endpoints, or other system config. Users should be aware that, if given a path to a sensitive file, the tool will read it — this is expected behavior but worth noting.

Install Mechanism

There is no install spec; the skill is instruction-driven and invokes an included Python script. The SKILL.md and code both claim zero dependencies and the script uses only the Python standard library.

Credentials

The skill requests no environment variables, credentials, or config paths. The code does not attempt to read environment variables or external credentials.

Persistence & Privilege

always is false and the skill does not modify agent/system configuration or persist credentials. It runs only when invoked and does not escalate privileges.

Assessment

This skill runs the included Python script locally against whatever file you tell it to analyze; it does not contact external services or require credentials. Before installing or invoking, review the script if you have sensitive files — the tool will read any file path you provide. No network exfiltration or hidden behavior was detected, and the implementation uses only the Python standard library.

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

Usage

Full analysis

python3 {baseDir}/scripts/text_stats.py analyze document.txt
python3 {baseDir}/scripts/text_stats.py analyze document.md

Word count only

python3 {baseDir}/scripts/text_stats.py wc document.txt

Keyword density

python3 {baseDir}/scripts/text_stats.py keywords document.txt --top 20

Reading time

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.