caveman-compress

Compress natural language markdown memory files to reduce token usage.

Updated Nov 16, 2022
One-click install
npx skills add https://github.com/kos3nz/dotfiles --skill caveman-compress-kos3nz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caveman-compress
Source: https://github.com/kos3nz/dotfiles/tree/main/.config/agents/skills/caveman-compress
Command: npx skills add https://github.com/kos3nz/dotfiles --skill caveman-compress-kos3nz

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Compress natural language memory files to reduce per-session token usage while preserving content integrity.

Core Features & Use Cases

  • Provides a deterministic caveman compression workflow for prose markdown files.
  • Preserves code blocks, URLs, headings, and file paths exactly; offers backup as <filename>.original.md.
  • Validates results and retries up to two times with targeted fixes to ensure safe, accurate compression.

Quick Start

Run a natural-language markdown file through the caveman-compress workflow to reduce token load.

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 from markdown memory files in Claude?

To reduce token usage from markdown memory files, you can compress prose files like CLAUDE.md using a deterministic compression workflow that preserves code blocks, URLs, and headings while minimizing context tokens during interactions.

What is the best way to compress markdown context files without losing code blocks?

The best way to compress markdown context files without losing code blocks is using a caveman compression workflow that preserves code blocks, URLs, headings, and file paths exactly while reducing natural language token load.

Can I restore my original markdown file after token compression?

Yes, you can restore your original markdown file after token compression because the workflow automatically preserves backups as <filename>.original.md before applying any compression changes to the active memory file.

Does markdown file compression work on large memory files?

Markdown file compression works on memory files up to 500KB, enforcing a strict size limit and refusing to process sensitive filenames to ensure safe compression within Claude interaction contexts.

What happens if markdown compression breaks my file formatting?

If markdown compression breaks your file formatting, the workflow validates outputs and retries up to two times with targeted fixes to ensure safe, accurate compression and content integrity.

When should I not use token compression for markdown memory files?

You should not use token compression for markdown memory files if your file exceeds 500KB, contains sensitive filenames, or relies heavily on natural language prose nuances that cannot withstand deterministic compression.