claude-md-improver

Installation
Summary

Audit and improve CLAUDE.md files to optimize Claude Code's project context.

  • Discovers all CLAUDE.md variants (project root, local overrides, package-specific, global defaults) and evaluates each against a quality rubric covering commands, architecture clarity, patterns, conciseness, currency, and actionability
  • Outputs a detailed quality report with file-by-file scores and specific improvement recommendations before making any changes
  • Applies targeted, minimal updates only after user approval, preserving existing content and showing diffs for each addition
  • Flags common issues like stale commands, missing dependencies, outdated architecture, and undocumented gotchas that impede future Claude sessions
SKILL.md

CLAUDE.md Improver

Audit, evaluate, and improve CLAUDE.md files across a codebase to ensure Claude Code has optimal project context.

This skill can write to CLAUDE.md files. After presenting a quality report and getting user approval, it updates CLAUDE.md files with targeted improvements.

Workflow

Phase 1: Discovery

Find all CLAUDE.md files in the repository:

find . -name "CLAUDE.md" -o -name ".claude.md" -o -name ".claude.local.md" 2>/dev/null | head -50

File Types & Locations:

| Type | Location | Purpose |

Related skills

More from anthropics/claude-plugins-official

Installs
4.6K
GitHub Stars
19.2K
First Seen
Jan 21, 2026