What problem does it solve? CLAUDE.md files often become stale, sparse, or filled with generic advice, leaving Claude Code without accurate project context. This Skill audits every CLAUDE.md file in a repository, scores it against a structured rubric, and applies targeted improvements after user approval. ## Core Features & Use Cases - Discovery and Scoring: Finds all CLAUDE.md files (project root, local overrides, global defaults, monorepo packages) and grades each on commands, architecture clarity, conciseness, currency, and actionability. - Quality Report: Outputs a file-by-file assessment with numeric scores, letter grades, issues, and recommended additions before making any changes. - Targeted Updates: Proposes minimal diffs for genuinely useful additions like working commands, gotchas, and configuration quirks, then applies them with the Edit tool after confirmation. - Use Case: After a major refactor, run the audit to find that your build commands are outdated and your new packages/ directory is undocumented, then update CLAUDE.md with verified commands and architecture notes. ## Quick Start Ask the agent to audit and improve all CLAUDE.md files in this repository and show a quality report first.
