claude-md-improver

To audit CLAUDE.md files across a codebase, this skill automatically discovers files at the project root and nested packages, then generates a comprehensive quality assessment against a rubric covering commands, architecture, and patterns. It highlights gaps and proposes targeted updates.

Updating outdated CLAUDE.md context for legacy repositories involves running a repository-wide audit. This skill identifies outdated information, generates a minimal project-specific update plan, and provides diffs with rationale for reviewer approval.

A CLAUDE.md quality assessment rubric works by evaluating files against criteria like commands, architecture, patterns, and currency. This skill applies the rubric to highlight missing context and document practical changes needed for future Claude sessions.

You can review and approve CLAUDE.md changes before they are applied. The skill generates a minimal, project-specific update plan and diffs with rationale, ensuring you maintain control over the actual file modifications.

You do not need any dependencies to scan nested packages for CLAUDE.md files. The skill operates without external dependencies to discover files and assess project context quality across your repository structure.

You should refresh memory and project context in CLAUDE.md when onboarding a new project, maintaining team standards, or updating legacy repos. This ensures Claude Code sessions start with accurate, high-quality context.