claude-md-improver

To audit CLAUDE.md files across a repository, this skill scans for all instances, evaluates them against predefined templates and quality criteria, and outputs a structured quality report highlighting inconsistencies and areas for improvement.

The best way to fix inconsistent project context in markdown files is to evaluate them against quality criteria and templates, then apply targeted updates to ensure the documentation accurately reflects the current codebase and prevents confusion.

Yes, you can review package-level CLAUDE.md files. The skill supports both project-wide audits and module-level reviews, using specific template guidance to ensure high-quality context at any level.

The quality audit handles applying updates by first generating a structured quality report with proposed precise edits, and then applying those targeted updates to the markdown files only after receiving explicit approval.

CLAUDE.md files drift from quality benchmarks when repository updates are not reflected in the documentation, leading to inconsistent project context and confusion during Claude sessions.