# sample-text-processor

sample-text-processor — a basic reference skill for word counting, character metrics, and batch case changes in plain text files. Built as a structural template for skill testing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 118 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/skill-tester/assets/sample-skill/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-sample-text-processor

## What it does

This skill provides core text manipulation utilities via the `text_processor.py` CLI script. It calculates total word count, distinct words, line totals, character counts, and the most frequent token. It can also transform text casing to uppercase, lowercase, or title case across single files or whole directories.

The tool outputs results as formatted terminal text or structured JSON files. Its internal architecture divides tasks between `TextProcessor`, `OutputFormatter`, and `FileManager` classes, backed by basic streaming to handle larger files without high memory usage.

Execution requires only Python 3.7 or newer without third-party packages. Because it adheres strictly to basic tier boundaries, it lacks support for rich formats like PDF or docx, working solely with plain text files.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill sample-text-processor -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sample-skill/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sample-skill/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill sample-text-processor -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sample-skill/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill sample-text-processor -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sample-skill/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/skill-tester/assets/sample-skill
```

2. **Manually: put the files in place**
- File: `.github/skills/sample-skill/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill sample-text-processor -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/skill-tester/assets/sample-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sample-skill/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill sample-text-processor -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/skill-tester/assets/sample-skill/SKILL.md

## When to use it
- gather word and character metrics for plain text files
- find the most repeated word inside a document
- convert text casing to uppercase or title case via CLI
- batch process folders of text notes into JSON summary files

## Example prompts
- Analyze document.txt and export metrics to results.json
- Transform draft.txt to title case and save as output.txt
- Run batch analysis on the text_files directory

## Similar
- [fixing-claude-export-conversations](https://affpapa.org/en/nevibecode/skills/fixing-claude-export-conversations.md) — skill · 825 installs
- [amc-run-sample-calibration](https://affpapa.org/en/nevibecode/skills/amc-run-sample-calibration.md) — skill · 647 installs
- [text-to-speech](https://affpapa.org/en/nevibecode/skills/text-to-speech.md) — skill · 22900 installs
- [docs-code-sample-standards](https://affpapa.org/en/nevibecode/skills/docs-code-sample-standards.md) — skill · 13300 installs
- [change-order-processor](https://affpapa.org/en/nevibecode/skills/change-order-processor.md) — skill · 123 installs
- [payment-application-processor](https://affpapa.org/en/nevibecode/skills/payment-application-processor.md) — skill · 117 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
