Compress a memory file such as CLAUDE.md or a todo list into caveman format to save input tokens, keeping a readable backup. Sends the file's text to the configured model provider. Trigger: /caveman-compress.
Security grade of this SKILL.md: SAFE · how we grade
How to install caveman-compress
npx skills add JuliusBrussee/caveman --skill caveman-compress -a claude-code
The skills CLI copies this one skill into Claude Code (use -a for another agent). Or read its SKILL.md on GitHub.
What the SKILL.md says
Data leaves the machine. Compression sends the file's full text to the model provider that scripts/compress.py is configured for: the claude CLI, 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 .original.md, but NOT beside the source file — it lives in an out-of-tree data dir ($XDG_DATA_HOME/caveman-compress/backups/ /, or %LOCALAPPDATA%\caveman-compress\backups\ \ on Windows) so skill auto-loaders don't re-ingest it as a live file. /caveman-compress or when user asks to compress a memory file. Requires an explicit filepath.
Other skills in JuliusBrussee/caveman
cavecrewWhen to delegate to `cavecrew-investigator` (locate code), `cavecrew-builder` (1-2 file edit) or `cavecrew-reviewer` (diff review) instead…
cavemanTerse caveman voice: answer first, fluff gone, every technical fact kept. Use for /caveman, "caveman mode", "talk like caveman", "be brief"…
caveman-commitWrite a Conventional Commits message compressed to intent only. Use for "write a commit", "commit message", /commit or /caveman-commit.
caveman-discoverFind and label every LLM workflow in the repository so Caveman Cloud groups spend by workflow instead of one bucket. Use for "discover work…
caveman-evidence-reviewRead-only review of Caveman Cloud evidence: cost, Cave Score, workflows, traces, latency, errors, routing, savings. Use when asked what Cav…
caveman-exploreRead-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the e…
caveman-helpQuick-reference card for the three caveman skills and their commands. Trigger: /caveman-help or "caveman help".
caveman-learnAct on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes…
caveman-manageInspect Caveman Cloud's experiment lifecycle and block unsafe execution. Use when asked to start, approve, cancel, promote or roll back a C…
caveman-optimizeTurn a Caveman optimization observation into an operator-chosen candidate with a paired baseline evaluation. Use when asked to inspect or e…
caveman-reviewCompressed code review - one line per finding with location, problem and fix. Use for /caveman-review, "review this PR", or "review the dif…
caveman-setupWire a repository through the Caveman Cloud gateway so every LLM request is measured, with no behavior change. Use for "set up caveman" or…
caveman-statsShow recorded output and cache-read token usage and mode attribution for the current Claude Code session, or locate the host's native usage…
investigate-firstDiagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needi…
lean-buildBuild feature work with high overbuilding risk. Use for new behavior, product slices, or integrations where repository reuse, strict scope,…
megacaveCaveman in Classical Chinese: 文言文 register, far fewer characters, technical terms verbatim. Invoke only with /megacave or /caveman wenyan.…
migrationImplement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring…
safe-refactorRestructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket…
surgical-patchFix bugs and small behavior changes at the narrowest responsible layer. Use when regression proof, preserved surrounding behavior, and task…
ultracaveCaveman at maximum compression: fragments, one word when one word is enough, each fact once. Invoke only with /ultracave or /caveman ultra.…