caveman-compress

A skill in JuliusBrussee/caveman · 121,496 stars on GitHub

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

  • cavecrew When to delegate to `cavecrew-investigator` (locate code), `cavecrew-builder` (1-2 file edit) or `cavecrew-reviewer` (diff review) instead…
  • caveman Terse caveman voice: answer first, fluff gone, every technical fact kept. Use for /caveman, "caveman mode", "talk like caveman", "be brief"…
  • caveman-commit Write a Conventional Commits message compressed to intent only. Use for "write a commit", "commit message", /commit or /caveman-commit.
  • caveman-discover Find 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-review Read-only review of Caveman Cloud evidence: cost, Cave Score, workflows, traces, latency, errors, routing, savings. Use when asked what Cav…
  • caveman-explore Read-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the e…
  • caveman-help Quick-reference card for the three caveman skills and their commands. Trigger: /caveman-help or "caveman help".
  • caveman-learn Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes…
  • caveman-manage Inspect Caveman Cloud's experiment lifecycle and block unsafe execution. Use when asked to start, approve, cancel, promote or roll back a C…
  • caveman-optimize Turn a Caveman optimization observation into an operator-chosen candidate with a paired baseline evaluation. Use when asked to inspect or e…
  • caveman-review Compressed code review - one line per finding with location, problem and fix. Use for /caveman-review, "review this PR", or "review the dif…
  • caveman-setup Wire a repository through the Caveman Cloud gateway so every LLM request is measured, with no behavior change. Use for "set up caveman" or…
  • caveman-stats Show recorded output and cache-read token usage and mode attribution for the current Claude Code session, or locate the host's native usage…
  • investigate-first Diagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needi…
  • lean-build Build feature work with high overbuilding risk. Use for new behavior, product slices, or integrations where repository reuse, strict scope,…
  • megacave Caveman in Classical Chinese: 文言文 register, far fewer characters, technical terms verbatim. Invoke only with /megacave or /caveman wenyan.…
  • migration Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring…
  • safe-refactor Restructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket…
  • surgical-patch Fix bugs and small behavior changes at the narrowest responsible layer. Use when regression proof, preserved surrounding behavior, and task…
  • ultracave Caveman at maximum compression: fragments, one word when one word is enough, each fact once. Invoke only with /ultracave or /caveman ultra.…