Terminal
Terminal/Skill
Compresses a memory file like CLAUDE.md or a todo list into a shorter format to save input tokens, keeping a backup.
By Julius Brussee
Works with
npx skills add juliusbrussee/caveman --skill caveman-compressData leaves the machine. Compression sends the file's full text to the model provider that
scripts/compress.pyis configured for: theclaudeCLI, the Anthropic API, or an OpenAI-compatible endpoint. Files whose names look like secrets (.env,credentials,secrets,.netrc, …) are refused before they are read. Don't compress a file the provider shouldn't see.
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 ($XDG_DATA_HOME/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.
/caveman-compress <filepath> or when user asks to compress a memory file.
Requires an explicit filepath. If the user pastes raw text instead of naming a file, do NOT improvise an inline compression — ask them for the filepath to compress, or offer to save the pasted text to a file first. Writing your own reasoning/commentary about the request into the compressed output (e.g. "User passed text directly, not a filepath...") is the exact failure this guards against — never let that leak into a saved file.
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.
From the directory containing this SKILL.md, run:
python3 -m scripts <absolute_filepath>
backtick content)/src/components/..., ./config.yaml)npm install, git commit, docker build)$HOME, NODE_ENV)CRITICAL RULE:
Anything inside ... must be copied EXACTLY.
Do not:
Inline code (...) must be preserved EXACTLY.
Do not modify anything inside backticks.
If file contains code blocks:
Original:
You should always make sure to run the test suite before pushing any changes to the main branch. This is important because it helps catch bugs early and prevents broken builds from being deployed to production.
Compressed:
Run tests before push to main. Catch bugs early, prevent broken prod deploys.
Original:
The application uses a microservices architecture with the following components. The API gateway handles all incoming requests and routes them to the appropriate service. The authentication service is responsible for managing user sessions and JWT tokens.
Compressed:
Microservices architecture. API gateway route all requests to services. Auth service manage user sessions + JWT tokens.