claudemd-optimization - Optimize CLAUDE.md with best practices and progressive disclosure
Optimizes CLAUDE.md by reducing verbosity, classifying sections into keep/move/delete, and relocating detailed content to agent_docs/ following HumanLayer best practices.
Tags
Updated: 2026-06-30Capabilities
Typical Inputs
Typical Outputs
What this skill does
- count CLAUDE.md lines
- classify CLAUDE.md sections
- create agent_docs directory
- move detailed content to agent_docs
- rewrite CLAUDE.md to target structure
- verify optimization line count
- check orphaned agent_docs references
Inputs
- CLAUDE.md file
- Project directory structure
- Existing agent_docs directory (optional)
Outputs
- Optimized CLAUDE.md file (60-200 lines)
- agent_docs directory with extracted documentation
- Progressive disclosure reference table in CLAUDE.md
- Verification report of optimization metrics
Requirements
- Claude Code environment with CLAUDE.md support
- Write access to project root directory
- Bash or shell access for line counting and grep