claude-md-improver

To audit CLAUDE.md files in a monorepo, the skill scans for root, local, and nested module variants, scores them against quality criteria, and produces a report before applying targeted improvements. This ensures consistent project context across all modules.

Claude Code misses build steps when CLAUDE.md files are stale, incomplete, or low-signal. Auditing these files evaluates commands, workflows, and architecture clarity, then applies minimal diffs to add genuinely helpful context and required commands.

A high-quality CLAUDE.md file features accurate commands, clear architecture context, non-obvious gotchas, conciseness, and actionability. The skill scores each file against these criteria to identify missing context and improve documentation quality.

Yes, you can review changes before updates. The skill produces a file-by-file quality report first, then applies targeted minimal diffs to add helpful context only after receiving your explicit confirmation, preserving the original structure.

Yes, the context optimization tool works with nested local override files. It scans the repository for CLAUDE.md plus local and nested variants to cover roots, overrides, and monorepo modules for consistent documentation.