What problem does it solve? Large project memory files like CLAUDE.md, todo lists, and preference notes are loaded into every AI session, repeatedly consuming input tokens. This Skill compresses those natural-language files into a terse caveman format while preserving code blocks, URLs, headings, and file paths exactly, cutting token usage by roughly 40-60% on benchmarked fixtures. ## Core Features & Use Cases - Token-reducing compression: Rewrites prose by removing articles, filler, hedging, and redundant phrasing while keeping technical terms, commands, and structure intact. - Safe in-place overwrite with backup: The original is saved byte-for-byte to an out-of-tree data directory as <filename>.original.md, and the compressed output is written atomically only after validation passes. - Structural validation with targeted repair: Headings, code blocks, URLs, file paths, and inline code are verified after compression; only failing sections are sent back for targeted fixes, with up to two retries. - Use Case: A developer with a 1,100-token CLAUDE.md runs the skill once, reducing it to about 640 tokens so every subsequent session starts with a smaller context footprint. ## Quick Start Ask the AI to run /caveman-compress on your CLAUDE.md file to shrink it and keep a readable backup.
