caveman-compress

Compresses natural language files like CLAUDE.md into a caveman format to reduce tokens for Claude sessions.

Updated May 11, 2026
One-click install
npx skills add https://github.com/guhans6/agent-workbench --skill caveman-compress-guhans6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caveman-compress
Source: https://github.com/guhans6/agent-workbench/tree/main/shared/skills/caveman-compress
Command: npx skills add https://github.com/guhans6/agent-workbench --skill caveman-compress-guhans6

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires anthropic, and includes scripts (resource) components.

What problem does it solve?

The Skill addresses the issue of high token usage by Claude, which can be expensive. It compresses memory files into a caveman format, reducing token usage for every session.

Core Features & Use Cases

  • File Compression: Compresses memory files like CLAUDE.md, todos, and preferences to save on tokens.
  • Token Reduction: Average savings of 46% on context tokens for memory files.
  • Use Case: When you have a project with a CLAUDE.md file containing instructions and preferences that loads on every session. Using caveman-compress will save you from high token costs.

Quick Start

Use the /caveman-compress command followed by the path to the file you want to compress.

Frequently Asked Questions about caveman-compress

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

FAQPage Schema
How do I reduce token usage for Claude AI memory files?

You can reduce token usage by compressing natural language memory files into a caveman format. This optimization preserves all content integrity and structure while saving an average of 46% on context tokens.

How do I compress a CLAUDE.md file to save on Claude API costs?

Compress your CLAUDE.md file by running the /caveman-compress command followed by the file path. This reduces input tokens loaded on every session, directly lowering your Claude API budget costs.

Can I use Python to compress project memory files for Claude sessions?

Yes, this file compression is implemented using Python scripts. It requires the Claude API to process the natural language compression logic and optimize your project memory files for efficient session usage.

Does compressing project memory files preserve the original content structure?

Yes, compressing project memory files preserves all content integrity and structure. The compression mechanism reduces input tokens without losing the original instructions, preferences, or.todos data stored in the files.

What are the limitations of using caveman format compression for Claude AI memory?

The compression requires a Claude API dependency to function. It is specifically designed for natural language memory files rather than arbitrary code files, targeting project management context optimization.