Text Tools Skill

Text processing utilities for common operations.

When to Use

✅ USE this skill when:

• "Count words in this text"

• "Convert text to uppercase/lowercase"

• "Remove duplicate lines"

• "Sort lines alphabetically"

• "Find and replace text"

When NOT to Use

❌ DON'T use this skill when:

• Complex regex operations → use sed/awk directly

• File encoding conversion → use iconv

• Binary file processing → use file-specific tools

Commands

Statistics

{baseDir}/text.sh stats <file> {baseDir}/text.sh stats --stdin < file.txt echo "text" | {baseDir}/text.sh stats --stdin

Transform Case

{baseDir}/text.sh upper <file> {baseDir}/text.sh lower <file> {baseDir}/text.sh title <file> {baseDir}/text.sh sentence <file>

Clean Text

{baseDir}/text.sh trim <file> {baseDir}/text.sh dedup <file> {baseDir}/text.sh strip-blank <file> {baseDir}/text.sh normalize-spaces <file>

Sort & Unique

{baseDir}/text.sh sort <file> {baseDir}/text.sh sort --reverse <file> {baseDir}/text.sh sort --numeric <file> {baseDir}/text.sh unique <file> {baseDir}/text.sh unique --count <file>

Find & Replace

{baseDir}/text.sh replace <file> "old" "new" {baseDir}/text.sh replace <file> --regex "pat.*tern" "replacement" {baseDir}/text.sh replace <file> --ignore-case "OLD" "new"

Encoding

{baseDir}/text.sh encode base64 <file> {baseDir}/text.sh encode url <file> {baseDir}/text.sh encode html <file> {baseDir}/text.sh encode hex <file>

Decode

{baseDir}/text.sh decode base64 <file> {baseDir}/text.sh decode url <file> {baseDir}/text.sh decode html <file> {baseDir}/text.sh decode hex <file>

Options

• --stdin : Read from stdin instead of file

• --out <file> : Write to file instead of stdout

• --regex : Use regex pattern for replace

• --ignore-case : Case-insensitive matching

• --reverse : Reverse sort order

• --numeric : Numeric sort

• --count : Show count with unique

Examples

Count words, lines, characters:

{baseDir}/text.sh stats document.txt

Output: Lines: 100, Words: 500, Chars: 3000

Remove duplicate lines:

{baseDir}/text.sh dedup data.txt

Sort and count duplicates:

{baseDir}/text.sh unique --count log.txt

Output: 42 error

15 warning

5 info

URL decode:

{baseDir}/text.sh decode url --stdin <<< "hello%20world"

Output: hello world

Notes

• All commands can read from stdin with --stdin

• Original files are never modified (output to stdout)

• Use --out to save to a file