claude-md-optimizer

Optimization focuses on reducing verbosity, improving structure, and replacing embedded content with references to source files. The Skill analyzes your CLAUDE.md against best practices and produces a concise, actionable report with specific edits and an optional optimized version.

A strong CLAUDE.md includes essential sections for project context, uses progressive disclosure by referencing files instead of copying content, and maintains readability through clear organization. The Skill identifies missing sections and suggests structural improvements.

Yes. Provide your CLAUDE.md and project structure, and the Skill performs an automated assessment checking for essential sections, overall readability, and adherence to best practices, then delivers a 100-200 line report with actionable recommendations.

Referencing source files keeps documentation concise, reduces maintenance burden, and ensures Claude Code always reads current content directly from the codebase rather than stale copies, improving accuracy and effectiveness.

A verbose CLAUDE.md duplicates file content and lacks clear structure, forcing Claude to parse unnecessary detail. An optimized version points to relevant files, follows progressive disclosure, and presents only essential context, enabling faster, more accurate interpretation.

Yes. The Skill directly applies Claude Code best practices for documentation, focusing on conciseness, reference-driven guidance, and structured clarity to help Claude interpret your codebase more effectively.