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 scans every CLAUDE.md in a repository, scores each one against a weighted quality rubric, and applies targeted updates after user approval. ## Core Features & Use Cases - Repository-wide discovery: Finds root, package-level, local override, and global CLAUDE.md files across monorepos and nested directories. - Scored quality report: Grades each file A-F across six criteria (commands, architecture, patterns, conciseness, currency, actionability) with specific issues and recommended additions. - Targeted updates with diffs: Proposes minimal, project-specific additions shown as diffs, then applies them with the Edit tool only after confirmation. - Use Case: After a sprint that changed build commands and added a new package, run the audit to flag stale commands in the root CLAUDE.md and generate a missing package-level file from the monorepo template. ## Quick Start Ask the assistant to audit all CLAUDE.md files in this repository and produce a quality report with recommended improvements.
