Can I revert changes if the compression is too aggressive?

Yes, the skill maintains a persistent versioning system in your temporary directory, allowing you to rollback to any previous iteration.

Does this work on user-facing README files?

No, the skill specifically targets Claude-facing configuration and instruction files like .claude/ settings to avoid breaking human-readable documentation.

What is 'Execution Equivalence'?

Execution Equivalence is a metric that ensures a reader (or AI) following the compressed instructions will achieve the exact same results as someone following the original version.

Will it break my code style rules?

The skill includes special handling for style documentation to preserve detection patterns and mandatory section headers while only condensing the explanatory text.

How does it handle CLAUDE.md specifically?

It reorganizes CLAUDE.md into a slim routing document (~200 lines) that directs agents to specialized sub-files, reducing overall redundancy.

Documentation Compressor

Name: Documentation Compressor
Author: cowwoc

bycowwoc

•

コンテンツ管理

Reduces documentation size while maintaining perfect execution equivalence for AI agents.

The shrink-doc skill optimizes Claude-facing documentation by condensing verbose explanations and reorganizing content into a more efficient hub-and-spoke model. It employs a validation-driven workflow that compares compressed versions against original baselines to ensure instructions remain functionally identical for AI agents while significantly reducing token usage. By distinguishing between Claude-facing configurations and human-facing docs, it safely streamlines your project's internal guidance system without compromising readability for developers.

主な機能

01Validation-driven compression with execution equivalence scoring

02Intelligent filtering to prevent modification of human-facing documentation

03Smart reorganization of CLAUDE.md into efficient hub-and-spoke patterns

042 GitHub stars

05Section-header protection for style detection and rule-based files

06Automated baseline preservation and persistent versioning for safe rollbacks

ユースケース

01Optimizing slash command prompts and agent definitions for faster execution

02Consolidating redundant project instructions across multiple documentation files

03Shrinking oversized CLAUDE.md files that consume too much context

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cowwoc/claude-code-cat shrink-doc

For use in Claude.ai and ChatGPT

Download Skill