Caveman Compress

Compress natural language memory files into caveman-speak to reduce input tokens.

- Reduces token usage by removing articles, filler words, hedging, and redundant phrasing while preserving all code, URLs, file paths, and technical terms exactly

- Works on .md, .txt, .typ, .typst, .tex, and extensionless files; skips code files and mixed-content sections automatically

- Triggered via /caveman:compress <filepath> command or user request; creates human-readable backup as FILE.original.md before overwriting

- Includes validation and up to 2 automatic retries on compression errors; leaves original untouched if all retries fail

Caveman Compress

Purpose

Compress natural language files (CLAUDE.md, todos, preferences) into caveman-speak to reduce input tokens. Compressed version overwrites original. Human-readable backup saved as <filename>.original.md.

Trigger

/caveman:compress <filepath> or when user asks to compress a memory file.

Process

-

This SKILL.md lives alongside scripts/ in the same directory. Find that directory.

-

Run:

cd <directory_containing_this_SKILL.md> && python3 -m scripts <absolute_filepath>