claude-md-review

What problem does it solve?

It reduces confusion and wasted effort caused by CLAUDE.md becoming unclear, redundant, outdated, or missing critical enforcement details.

Core Features & Use Cases

• Structure and readability auditing: Checks whether related topics are grouped logically or scattered.
• Redundancy detection: Identifies duplicated statements and repeated guidance that should be consolidated.
• Staleness and coverage review: Flags broken references to files or patterns that no longer exist and finds gaps between what the code enforces and what the docs explain.
• Optimization for concision: Rates bloat and suggests removals or streamlining.

Quick Start

Run this skill to review the contents of CLAUDE.md end-to-end and post an effectiveness report and, if the rating is under 8, a concrete restructure plan.