skills.rest
SaltFishGC
SaltFishGCCOMMUNITY
Explore all skills by this author →
GitHub

caveman-compress

Compress prose-heavy memory files into compact caveman format with backups.

Updated Jun 20, 2025
Search Tags:#markdown#validation#claude#backup#token optimization#file compression#caveman
One-click install
npx skills add https://github.com/SaltFishGC/SaltFishGC.github.io --skill caveman-compress-saltfishgc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: caveman-compress
Source: https://github.com/SaltFishGC/SaltFishGC.github.io/tree/main/.trae/skills/caveman-compress
Command: npx skills add https://github.com/SaltFishGC/SaltFishGC.github.io --skill caveman-compress-saltfishgc

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill reduces the recurring token cost of large project memory files by compressing natural-language notes into a shorter, easier-to-load format without losing the important instructions.

Core Features & Use Cases

  • Memory Compression: Shrinks CLAUDE.md, todo lists, preference files, and other prose-heavy notes into compact caveman-style text.
  • Safety Preservation: Keeps headings, code blocks, inline code, URLs, file paths, commands, tables, and technical terms intact.
  • Reliable Workflow: Creates a human-readable backup, validates the compressed output, and retries targeted fixes when preservation checks fail.
  • Use Case: Use it when a project memory file has grown large and you want every future session to start with fewer tokens while keeping the same guidance.

Quick Start

Ask the skill to compress your memory file, such as CLAUDE.md, while preserving its structure and saving the original as a backup.

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 in CLAUDE.md project memory files?▼

Reduce token usage in CLAUDE.md project memory files by compressing natural-language prose into a compact caveman format. This shrinks recurring token costs while preserving headings, code blocks, URLs, file paths, and tables.

What is caveman format compression for markdown notes?▼

Caveman format compression for markdown notes is a token optimization technique that shortens prose-heavy text into a compact style. It keeps technical elements like inline code, commands, and structural formatting intact to maintain file guidance.

Can I compress markdown todo lists and preference files without losing code blocks?▼

Yes, you can compress markdown todo lists and preference files without losing code blocks. The compression process preserves headings, inline code, URLs, file paths, commands, and tables while shortening the surrounding natural language.

Does file compression create a backup before modifying the original markdown?▼

Yes, file compression creates a human-readable backup of the original markdown before any modifications. It also validates the compressed output and applies targeted retry fixes if preservation checks fail.

Do I need tiktoken and anthropic dependencies to optimize markdown tokens?▼

Yes, you need the tiktoken and anthropic dependencies to optimize markdown tokens. These libraries provide the token counting and AI processing capabilities required to compress and validate the memory files.

Related Skills

Explore More Software Engineering Skills→
jubalmjubalm
1

claude-code-memory

Manage Claude Code project memory with structured files and Python utilities.

Community
Advanced
fmflurryfmflurry
171

compress

Compress natural language memory files into caveman format with backup.

Community
Advanced
georgekhananaevgeorgekhananaev
27

token-formatter

Compress Markdown and text into token-efficient formats with Python scripts.

Community
Advanced
qmuqmu
1

translate

Translate English Markdown files while preserving formatting and frontmatter semantics.

Official
Basic