# Text Analyzer

Analyze text content and produce statistics including word count, line count, character...

- Repository: https://github.com/NVIDIA/SkillEvaluator (620 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add NVIDIA/SkillEvaluator --skill text-analyzer -g -a claude-code -y`
Codex: `npx skills add NVIDIA/SkillEvaluator --skill text-analyzer -g -a codex -y`
Cursor: `npx skills add NVIDIA/SkillEvaluator --skill text-analyzer -g -a cursor -y`
Gemini CLI: `npx skills add NVIDIA/SkillEvaluator --skill text-analyzer -g -a gemini-cli -y`

## Description

Analyze text content and produce statistics including word count, line count, character count, most frequent words, and readability metrics. Works on any plain text input provided inline or from a file path.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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