Agent skill · JuliusBrussee
caveman-compress
Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens. Preserves all technical substance, code, URLs, and structure. Compressed version overwrites the original file. Human-readable backup saved as FILE.original.md. Trigger: /caveman-compress FILEPATH or "compress memory file
What it needs
About 3k tokens when loaded.
What this skill does
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, but NOT beside the source file — it lives in an out-of-tree data dir ($XDGDATAHOME/caveman-compress/backups/<parent-dir-name>/, or %LOCALAPPDATA%\caveman-compress\backups\<parent-dir-name>\ on Windows) so skill auto-loaders don't re-ingest it as a live file. Trigger /caveman-compress <filepath> or when user asks to compress a memory file. Process 1. The compression scripts live in scripts/ (adjacent to this SKILL.md). If the path is not immediately available, search for scripts/main.py next to this SKILL.md. 2. From the directory containing this SKILL.md, run: python3 -m scripts <absolutefilepath> 3. The CLI will: detect file type (no tokens) call Claude to compress validate output (no tokens) if errors: cherry-pick fix with Claude (targeted fixes only, no recompression) retry up to 2 times if still failing after 2 retries: report error to user, leave original file untouched 4. Return result to user Compression Rules Remove Articles: a, an, the Filler: just, really, basically, actually, simply, essentially, generally Pleasantries: "sure", "certainly", "of course", "happy to", "I'd recommend" Hedging: "it might be worth", "you could consider", "it would be good to" Redundant phrasing: "in order to" → "to", "make sure to" → "ensure", "the reason is because" → "because" Connective fluff: "however", "furthermore", "additionally", "in addition" Preserve EXACTLY (never modify) Code blocks (fenced ... must be copied EXACTLY. Do not: remove comments remove spacing reorder lines shorten commands simplify anything Inline code (...`) must be preserved EXACTLY. Do not modify anything inside backticks. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills JuliusBrussee/caveman-compress