What is execution equivalence in document compression?

Execution equivalence ensures that an AI agent following the compressed documentation will achieve the exact same results and follow the same constraints as it would with the original version.

Will it break my custom slash commands?

No, the skill is designed to recognize and preserve required YAML frontmatter and structural metadata essential for Claude Code's command execution.

Does this skill modify my project's README.md?

No, Doc Shrink explicitly forbids the compression of human-facing documents like README.md, changelogs, and study notes to ensure your public documentation stays readable.

How does it handle the CLAUDE.md file?

It uses a reorganization pattern that moves agent-specific instructions to separate files and leaves CLAUDE.md as a slim universal reference, usually under 200 lines.

Can I revert the changes if the compression is too aggressive?

Yes, the skill saves a baseline of the original document and maintains versioned copies in a temporary directory for comparison and rollback.

Doc Shrink

Name: Doc Shrink
Author: cowwoc

bycowwoc

•

Learning & Documentation

Compresses Claude-facing documentation to reduce token usage while maintaining perfect execution equivalence.

Doc Shrink is a specialized utility for Claude Code designed to optimize the context window by condensing documentation without losing functional meaning. It distinguishes between human-facing files and AI-facing configurations, applying a validation-driven approach to ensure that compressed instructions yield the same results as the original text. The skill is particularly effective at reorganizing bloated CLAUDE.md files into a streamlined hub-and-spoke model and protecting critical style detection patterns, helping developers maintain high-performance AI interactions in large repositories.