claude-md-audit

To audit CLAUDE.md files, this Skill discovers them throughout your repository and scores them against a defined quality rubric to surface documentation gaps. It generates a targeted improvement report without making any automatic changes.

The best way to improve CLAUDE.md documentation is using an automated audit that generates a targeted improvement plan. This Skill applies updates safely by presenting a quality report and requiring your explicit confirmation before modifying any files.

You can automatically apply updates to CLAUDE.md files, but a confirmation gate stops changes before they happen. The Skill generates a quality report detailing recommended updates and only applies them after you explicitly approve the modifications.

No, the CLAUDE.md audit does not modify project files directly without approval. It reads your files, scores them against a quality rubric, and requires explicit user confirmation at a gate before applying any updates to your documentation.

You need to run a CLAUDE.md quality audit when you want to establish ongoing documentation governance or surface gaps in project instructions. It helps ensure your codebase documentation meets a defined quality standard through a reusable workflow.

Your CLAUDE.md file needs a quality score to objectively identify documentation gaps and measure adherence to a defined rubric. Scoring provides a clear baseline for generating targeted improvements and maintaining high project-quality standards.