What problem does it solve?
CLAUDE.md files often lack critical project context, contain outdated information, or miss key details that Claude Code needs to work efficiently, leading to repeated context discovery, incorrect assumptions, and wasted effort during development sessions.
Core Features & Use Cases
- Comprehensive Discovery: Scans for all CLAUDE.md variants (root project, local overrides, global defaults, package-specific, nested) across codebases including monorepos.
- Standardized Quality Scoring: Evaluates each file against a 6-criterion rubric (commands, architecture, non-obvious patterns, conciseness, currency, actionability) to assign clear grades and identify documentation gaps.
- Targeted, Safe Updates: Generates a detailed quality report with specific issues and prioritized improvement recommendations, then applies minimal, context-aware updates only after explicit user approval.
- Use Case: For a fast-growing startup with a large monorepo where multiple teams maintain separate package-level CLAUDE.md files, use this skill to quickly audit all files, standardize documentation quality, and ensure Claude has consistent, up-to-date context across all modules.
Quick Start
Use the revise-claude-md skill to audit all CLAUDE.md files in your current repository and generate a prioritized quality improvement report with actionable recommendations.
