Sample Text Processor
Sample Text Processor is a reference BASIC-tier skill that counts words and characters and applies basic text transformations to text files. It serves as a fixture for testing skill-tester and as a template for creating new skills, providing dual output in JSON and human-readable formats.
✨ What it does
- Word count analysis: total words, unique words, and word frequency.
- Character statistics: character count, line count, and special characters.
- Text transformations: convert text to uppercase, lowercase, or title case.
- File processing: process single files or batch process directories.
- Dual output formats: generate results in both JSON and human-readable text.
- Command-line interface with argument parsing and error handling.
🎯 When to use it
- When validating or testing the skill-tester tool itself.
- When you need a minimal, known-good skill layout to copy as a template.
- When you require simple text statistics (word count, character count) or transformations (uppercase, lowercase, title case) on text files.
- When you want to demonstrate or learn the basic structure and documentation standards for BASIC-tier skills.
🚀 How to use
Trigger by running the Python script text_processor.py from the skill's scripts directory. Provide a command with an action (analyze, transform, or batch) and a file or directory path. Optional flags include --format, --output, --verbose, and --encoding. Example prompts:
python text_processor.py analyze document.txt
python text_processor.py transform document.txt --mode uppercase --output transformed.txt
📄 Output: The skill outputs text analysis statistics or transformed text, either to the console or to a specified output file, in JSON or human-readable format.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering/skills/skill-tester/assets/sample-skill .claude/skills/sample-skillSkill source: engineering/skills/skill-tester/assets/sample-skill/SKILL.md
⚠️ Good to know
As a BASIC-tier skill, it omits advanced features like sentiment analysis, PDF/Word support, database integration, and parallel processing.
❓ FAQ
What are the dependencies for this skill?
It requires only Python 3.7 or later with the standard library; no external dependencies are needed.
Can I process multiple files at once?
Yes, you can use the batch command to process a directory of text files, with progress reporting and configurable output.
What output formats are supported?
The skill supports both JSON and human-readable text formats, selectable via the --format option.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.