What problem does it solve?
Large project memory files like CLAUDE.md, todo lists, and preference documents are loaded into context at the start of every Claude Code session, leading to excessive, recurring token waste that adds up to significant overhead across hundreds of sessions.
Core Features & Use Cases
- Token-Efficient Compression: Reduces natural language memory file size by an average of 46% while preserving all code blocks, URLs, file paths, commands, and document structure exactly.
- Safe, Reversible Workflow: Automatically saves a human-readable backup of the original file as FILE.original.md before overwriting, so you can edit the original content and re-run compression at any time.
- Use Case: For a 1000-token project memory file, this Skill cuts per-session token overhead by nearly half, adding up to 100,000+ tokens saved across 100 sessions with no loss of critical context.
Quick Start
Request compression of your project's CLAUDE.md file using the caveman-compress skill to reduce per-session token costs.