caveman-compress

Compress natural language memory files to reduce token usage.

Updated Jan 24, 2026

Search Tags:#markdown #claude #memory #backup #tokens #compress #caveman

Ready to run

npx skills add https://github.com/Ikki-Group/erp --skill caveman-compress-ikki-group

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: caveman-compress
Source: https://github.com/Ikki-Group/erp/tree/main/.agents/skills/caveman-compress
Command: npx skills add https://github.com/Ikki-Group/erp --skill caveman-compress-ikki-group

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Compress natural language memory files (CLAUDE.md, todos, preferences) to reduce the token load on Claude sessions, preserving content and structure while enabling faster session starts.

Core Features & Use Cases

Deterministic compression workflow that detects natural-language files, compresses content with a Claude-based reduction, and writes back to the original file.
Automatic validation with targeted fixes and a safe backup of the original as <filename>.original.md.
Safety features including back-ups, file-size checks, and sensitive path heuristics to minimize data leakage risk.

Quick Start

Run caveman:compress <filepath> to compress a memory file and create a .original.md backup.

Frequently Asked Questions about caveman-compress

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I compress CLAUDE.md memory files to save tokens?▼

To compress memory files and save tokens, run caveman:compress <filepath>. This activates a deterministic workflow that reduces natural language content and writes the compressed version back to the original file.

Does compressing markdown memory files create a backup of the original content?▼

Compressing markdown memory files creates a safe backup of the original content automatically. Your uncompressed file is preserved as <filename>.original.md to prevent data loss during the token reduction process.

What happens if memory file compression loses important content?▼

If compression loses important content, the workflow runs automatic validation with targeted fixups. It attempts up to two retries to ensure content and structure are preserved while minimizing token costs.

Can I use this to compress personal todos and preferences for Claude sessions?▼

You can use this to compress personal todos and preferences for Claude sessions. The tool detects natural-language memory files and applies a Claude-based reduction to enable faster session starts.

Are there safety checks when reducing token usage in memory files?▼

Safety checks when reducing token usage include file-size checks and sensitive path heuristics. These features minimize data leakage risk while backing up your original markdown files before compression.