text-analyzer

Text Analyzer

Analyze text and produce structured statistics.

Purpose

Provide quick text analytics — word counts, line counts, character counts, top frequent words, average word length, and sentence count — for any plain-text input.

Agent Instructions

1. Read this SKILL.md to understand capabilities.
2. Run scripts/analyze_text.py with the appropriate arguments.
3. Return the analysis results to the user.

Examples

Usage

# Analyze inline text
python scripts/analyze_text.py --text "Your text content here"

# Analyze a file
python scripts/analyze_text.py --file /path/to/file.txt

# JSON output (default is human-readable)
python scripts/analyze_text.py --text "Hello world" --json

Output

The script prints a structured report with:

• Word count — total words
• Line count — total lines
• Character count — total characters (including whitespace)
• Sentence count — estimated sentence count
• Average word length — mean characters per word
• Top 5 words — most frequent words and their counts

Limitations

• Sentence detection uses simple period/question/exclamation splitting; may be inaccurate for abbreviations (e.g., "U.S.A.").
• Non-UTF-8 files will be read with errors replaced.

Troubleshooting

Problem	Fix
FileNotFoundError	Check the --file path exists
Empty output	Ensure --text or --file is provided