Agent skill

Sample Text Processor

by alirezarezvani in alirezarezvani/claude-skills

Reference BASIC-tier skill used as a fixture by skill-tester.

MITAuto-check passed

Install Sample Text Processor

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill sample-text-processor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills sample-text-processor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/skills/skill-tester/assets/sample-skill .claude/skills/sample-text-processor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sample-text-processor
GitHub stars
28k
Token cost
~1.5k tokens
SKILL.md length
558 words
Files
7 (incl. scripts, references, assets)
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

Reference BASIC-tier skill used as a fixture by skill-tester.

  • Works in 3 steps: Clone or download the skill directory → Navigate to the scripts directory → Run the text processor directly with…
  • Validating skill-tester itself
  • SKILL.md covers Description, Features, Usage and Examples, plus 7 more sections
  • Runs Python scripts from its folder; calls python

What it does

Sample Text Processor is an agent skill from alirezarezvani/claude-skills. Reference BASIC-tier skill used as a fixture by skill-tester. Counts words and characters and applies basic text transformations. Use when validating skill-tester itself or when you need a minimal, known-good skill layout to copy. Not a production skill.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts, reference files and assets (for example `README.md`, `expected_outputs/sample_text_analysis.json` and `references/api-reference.md`).

The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • Validating skill-tester itself
  • You need a minimal
  • Known-good skill layout to copy

Example prompts

  • “/sample-text-processor”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Clone or download the skill directory
  2. Navigate to the scripts directory
  3. Run the text processor directly with Python

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sample Text Processor loads about 1.5k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 69 tokens; SKILL.md has 558 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 558 words, ~1,458 tokens.

Download SKILL.mdSave it as .claude/skills/sample-text-processor/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
sample-text-processor
description
Reference BASIC-tier skill used as a fixture by skill-tester. Counts words and characters and applies basic text transformations. Use when validating skill-tester itself or when you need a minimal, known-good skill layout to copy. Not a production skill.

Sample Text Processor

This file is the fixture skill_validator.py and script_tester.py run against. It is deliberately minimal. Keep its frontmatter valid YAML and limited to the fields Claude Code reads: anything else here gets copied into new skills by authors treating it as a template.

Tier: BASIC. Dependencies: none, Python standard library only.

Description

The Sample Text Processor is a simple skill designed to demonstrate the basic structure and functionality expected in the claude-skills ecosystem. This skill provides fundamental text processing capabilities including word counting, character analysis, and basic text transformations.

This skill serves as a reference implementation for BASIC tier requirements and can be used as a template for creating new skills. It demonstrates proper file structure, documentation standards, and implementation patterns that align with ecosystem best practices.

The skill processes text files and provides statistics and transformations in both human-readable and JSON formats, showcasing the dual output requirement for skills in the claude-skills repository.

Features

Core Functionality
  • Word Count Analysis: Count total words, unique words, and word frequency
  • Character Statistics: Analyze character count, line count, and special characters
  • Text Transformations: Convert text to uppercase, lowercase, or title case
  • File Processing: Process single text files or batch process directories
  • Dual Output Formats: Generate results in both JSON and human-readable formats
Technical Features
  • Command-line interface with comprehensive argument parsing
  • Error handling for common file and processing issues
  • Progress reporting for batch operations
  • Configurable output formatting and verbosity levels
  • Cross-platform compatibility with standard library only dependencies

Usage

Basic Text Analysis
bash
python text_processor.py analyze document.txt
python text_processor.py analyze document.txt --output results.json
Text Transformation
bash
python text_processor.py transform document.txt --mode uppercase
python text_processor.py transform document.txt --mode title --output transformed.txt
Batch Processing
bash
python text_processor.py batch text_files/ --output results/
python text_processor.py batch text_files/ --format json --output batch_results.json

Examples

Example 1: Basic Word Count
bash
$ python text_processor.py analyze sample.txt
=== TEXT ANALYSIS RESULTS ===
File: sample.txt
Total words: 150
Unique words: 85
Total characters: 750
Lines: 12
Most frequent word: "the" (8 occurrences)
Example 2: JSON Output
bash
$ python text_processor.py analyze sample.txt --format json
{
  "file": "sample.txt",
  "statistics": {
    "total_words": 150,
    "unique_words": 85,
    "total_characters": 750,
    "lines": 12,
    "most_frequent": {
      "word": "the",
      "count": 8
    }
  }
}
Example 3: Text Transformation
bash
$ python text_processor.py transform sample.txt --mode title
Original: "hello world from the text processor"
Transformed: "Hello World From The Text Processor"

Installation

This skill requires only Python 3.7 or later with the standard library. No external dependencies are required.

  1. Clone or download the skill directory
  2. Navigate to the scripts directory
  3. Run the text processor directly with Python
bash
cd scripts/
python text_processor.py --help

Configuration

The text processor supports various configuration options through command-line arguments:

  • --format: Output format (json, text)
  • --verbose: Enable verbose output and progress reporting
  • --output: Specify output file or directory
  • --encoding: Specify text file encoding (default: utf-8)
Show full SKILL.md (216 more words)Show less

Architecture

The skill follows a simple modular architecture:

  • TextProcessor Class: Core processing logic and statistics calculation
  • OutputFormatter Class: Handles dual output format generation
  • FileManager Class: Manages file I/O operations and batch processing
  • CLI Interface: Command-line argument parsing and user interaction

Error Handling

The skill includes comprehensive error handling for:

  • File not found or permission errors
  • Invalid encoding or corrupted text files
  • Memory limitations for very large files
  • Output directory creation and write permissions
  • Invalid command-line arguments and parameters

Performance Considerations

  • Efficient memory usage for large text files through streaming
  • Optimized word counting using dictionary lookups
  • Batch processing with progress reporting for large datasets
  • Configurable encoding detection for international text

Contributing

This skill serves as a reference implementation and contributions are welcome to demonstrate best practices:

  1. Follow PEP 8 coding standards
  2. Include comprehensive docstrings
  3. Add test cases with sample data
  4. Update documentation for any new features
  5. Ensure backward compatibility

Limitations

As a BASIC tier skill, some advanced features are intentionally omitted:

  • Complex text analysis (sentiment, language detection)
  • Advanced file format support (PDF, Word documents)
  • Database integration or external API calls
  • Parallel processing for very large datasets

This skill demonstrates the essential structure and quality standards required for BASIC tier skills in the claude-skills ecosystem while remaining simple and focused on core functionality.

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references, assets) in engineering/skills/skill-tester/assets/sample-skill of alirezarezvani/claude-skills.

  • SKILL.md
  • README.md
  • assets/sample_text.txt
  • assets/test_data.csv
  • expected_outputs/sample_text_analysis.json
  • references/api-reference.md
  • scripts/text_processor.py

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Sample Text Processor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sample Text Processor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sample Text Processor this skillalirezarezvani/claude-skills28k—~1.5kAutomated safety check: PassMIT
Sample Size Basicaipoch/medical-research-skills2k—~1.6kAutomated safety check: PassMIT
Sample Text Processorborghei/Claude-Skills874—~1.4kAutomated safety check: PassMIT
Agent Testerruvnet/ruflo74k2 repos~2.1kAutomated safety check: PassMIT
Adk Sample Creatorgoogle/adk-python22k—~1.3kAutomated safety check: PassApache-2.0
Basicbergside/awesome-design-skills3.1k1 repos~969Automated safety check: PassMIT

Similar skills

  • Sample Size Basic

    aipoch/medical-research-skills

    Basic sample size estimator for clinical research planning. An agent skill from aipoch/medical-research-skills.

    2k GitHub stars~1.6k tokensUpdated 20 days ago
    Research & ScienceAuto-check passed
  • Sample Text Processor

    borghei/Claude-Skills

    Sample skill for testing the skill-tester validation pipeline.

    874 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Agent Tester

    ruvnet/ruflo

    Agent skill for tester - invoke with $agent-tester. An agent skill from ruvnet/ruflo.

    74k GitHub starsUsed in 2 repos~2.1k tokens
    Testing & QAAuto-check passed
  • Adk Sample Creator

    google/adk-python

    Official

    Creates a new sample agent in the ADK Python repository — the sample directory, its agent.py, and its README.md — following the conventions the existing samples already use.

    22k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Basic

    bergside/awesome-design-skills

    Print-inspired visual language for books, magazines, and reports with editorial grids and expressive typography.

    3.1k GitHub starsUsed in 1 repo~969 tokens
    Frontend & DesignAuto-check passed
  • Testing Core Processors

    mastra-ai/mastra

    A skill your agent uses when writing or debugging integration tests for error processors in packages/core/src/processors/.

    29k GitHub stars~1.1k tokensUpdated today
    Testing & QAAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Sample Text Processor

What does Sample Text Processor do?

Reference BASIC-tier skill used as a fixture by skill-tester. Sample Text Processor is an agent skill from alirezarezvani/claude-skills. Reference BASIC-tier skill used as a fixture by skill-tester.

When should I use Sample Text Processor?

Sample Text Processor fits situations like: validating skill-tester itself; you need a minimal; known-good skill layout to copy.

How do I install Sample Text Processor in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill sample-text-processor -a claude-code`. Or copy the skill folder (engineering/skills/skill-tester/assets/sample-skill in alirezarezvani/claude-skills) into .claude/skills/sample-text-processor in your project. Claude Code loads it when a task matches its description.

How do I install Sample Text Processor in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill sample-text-processor -a codex`. Or copy the skill folder (engineering/skills/skill-tester/assets/sample-skill in alirezarezvani/claude-skills) into .agents/skills/sample-text-processor in your project. Codex loads it when a task matches its description.

Can I use Sample Text Processor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill sample-text-processor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sample-text-processor, .gemini/skills/sample-text-processor, .github/skills/sample-text-processor and .opencode/skills/sample-text-processor in your project.

What does Sample Text Processor need to run?

Going by SKILL.md and its folder, Sample Text Processor needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Sample Text Processor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sample Text Processor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Sample Text Processor use?

Sample Text Processor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sample Text Processor use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 630 tokens, read only when the agent opens those files.

What are the alternatives to Sample Text Processor?

Skills that share tags, products or a category with Sample Text Processor: Sample Size Basic (aipoch/medical-research-skills, 2k stars), Sample Text Processor (borghei/Claude-Skills, 874 stars), Agent Tester (ruvnet/ruflo, 74k stars) and Adk Sample Creator (google/adk-python, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sample Text Processor?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,788 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.