Skip to content
Get packs

CLAUDE.md Improver

Audits your CLAUDE.md project memory files and proposes targeted improvements after your approval.

Source Download skill
Repository
anthropics/claude-plugins-official
Stars
45,770
Licence
Apache-2.0
Files
4 files

What it does

CLAUDE.md is a plain-text file that gives Claude Code standing context about a project, such as build commands, architecture and gotchas. With this skill installed, the agent can find every CLAUDE.md file in a repository, grade each one against a quality rubric, and output a written report. It then proposes specific additions as diffs and only edits the files after the user approves.

Great for

  • Developers who maintain a repository used with Claude Code and want its CLAUDE.md kept accurate
  • Teams with monorepos that have several package-level CLAUDE.md files
  • Anyone who wants a quality report on project memory before making changes

Skip it if

  • Projects that do not use CLAUDE.md or Claude Code, since the output has no effect elsewhere
  • Users who want unreviewed automatic edits, because the skill is written to ask for confirmation first; the approval step is part of the instructions, not enforced by code
  • Repositories with secrets in CLAUDE.md files, since the skill reads these files and may quote their contents into the report

Try asking

  • “Audit all the CLAUDE.md files in this repo and give me a quality score for each”
  • “Check whether our CLAUDE.md build and test commands are still accurate”
  • “Suggest improvements to the CLAUDE.md in packages/api based on the current code”
  • “Fix the outdated architecture section in CLAUDE.md”
Step-by-step guide: how to use CLAUDE.md ImproverInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 4 original files, the Apache-2.0 licence and an attribution note.

    claude-md-improver.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip claude-md-improver.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip claude-md-improver.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Review the quality report and each proposed diff before approving, since edits are written directly to files
  • Keep personal preferences in .claude.local.md, which the skill notes should be gitignored, rather than the shared project file
  • Ask for a report first and decide on updates afterward to limit changes to what you have reviewed

What's inside

  • references/quality-criteria.md
  • references/templates.md
  • references/update-guidelines.md
  • SKILL.md

Redistributed unmodified from anthropics/claude-plugins-official under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.