Claude Md Improver

anthropics/claude-plugins-officialOfficial

Think of this as a linter for your CLAUDE.md files. It finds all the CLAUDE.md files in your repo, grades them against actual quality criteria (commands present? architecture clear? current?), and shows you a scored report before making any changes. Then it proposes targeted fixes like adding missing build commands or documenting gotchas it found in the code. The quality rubric is solid: it penalizes verbose obvious stuff and rewards actionable copy-paste commands. Honestly most useful in monorepos where you've got multiple CLAUDE.md files that have drifted out of sync with reality.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 8
skills.sh installs: 14.2K
GitHub stars: 46.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add anthropics/claude-plugins-official --skill claude-md-improver --agent claude-code

Installs into .claude/skills of the current project.

Files

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
Project root	`./CLAUDE.md`	Primary project context (checked into git, shared with team)
Local overrides	`./.claude.local.md`	Personal/local settings (gitignored, not shared)
Global defaults	`~/.claude/CLAUDE.md`	User-wide defaults across all projects
Package-specific	`./packages/*/CLAUDE.md`	Module-level context in monorepos
Subdirectory	Any nested location	Feature/domain-specific context