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 ```bash # 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 |