1. Habit
  2. Skills
  3. CLAUDE.md Improver skill
Anthropic · 12K installs

CLAUDE.md Improver skill
Runs by itself, weekly on Monday.

Keep every CLAUDE.md current.

Install the CLAUDE.md Improver skill and make it a habit: follow https://gethabit.dev/skills/anthropics/claude-md-improver.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

12K installs44K starsApache-2.0 licenceSource on GitHub ↗

CLAUDE.md Improver

by Anthropic · 12K installs

The skill

The CLAUDE.md Improver skill audits the CLAUDE.md files in a repository, scores them against a quality rubric and proposes small targeted updates for teams that use Claude Code.

Only when you ask.

The habit

Keep every CLAUDE.md current.

↻ Runs by itselfweekly on Monday

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

weekly on Monday. Runs in Claude Code routine or cron.

  • ↻ weekly on Monday
  • 0 9 * * 1

02

It checks its work

report first, you approve. If a check fails, it tells you.

  • ✓quality report lists every CLAUDE.md found
  • ✓every file has a score out of 100
  • ✓no CLAUDE.md changes before approval
  • ✓each change comes with a diff and a reason

03

It remembers

CLAUDE.md score log. The next run reads it first: last score and open issues for each CLAUDE.md.

loops/claude-md-audit-loop/scores.md

One run, step by step.
Then it stops.

Stop ruleStops after one audit of up to 50 CLAUDE.md files per run.

  1. 01

    Discover files

    The agent finds every CLAUDE.md, .claude.md and .claude.local.md file in the repository.

  2. 02

    Assess quality

    It scores each file on commands, architecture, patterns, conciseness, currency and actionability.

  3. 03

    Write report

    It outputs the quality report with grades A to F before it changes anything.

  4. 04

    Propose diffs

    It shows small targeted additions as diffs, each with a short reason.

  5. 05

    Ask you

    You confirm which updates to apply.

  6. 06

    Apply updates

    It applies the approved changes with the Edit tool and keeps the existing structure.

  7. 07

    Log scores

    The loop writes each file's new score to the score log.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the CLAUDE.md Improver skill helps.

Use it when

  • ✓ Your CLAUDE.md feels outdated
  • ✓ You set up a monorepo with many CLAUDE.md files
  • ✓ Build or test commands changed

Skip it when

  • – You do not use Claude Code
  • – You want a CLAUDE.md written from scratch

Questions

CLAUDE.md Improver skill, answered.

Does it change files without asking?

No. It shows the report and the diffs first and only edits after you approve.

What does it flag?

Stale or broken commands, missing tools and env setup, outdated architecture and gotchas nobody wrote down.

Does it add generic advice?

No. It adds only project-specific facts and keeps each file short.

How do I install the CLAUDE.md Improver skill?

Copy the prompt at the top into your agent. It installs the skill from anthropics/claude-plugins-official and sets up the habit. Or run npx skills add anthropics/claude-plugins-official --skill claude-md-improver.

Is the CLAUDE.md Improver skill free?

Yes. It is published under Apache-2.0. Habit is free too.

CLAUDE.md Improver. Now as a habit.

Install the CLAUDE.md Improver skill and make it a habit: follow https://gethabit.dev/skills/anthropics/claude-md-improver.md

  • Free
  • No account
  • Undo in one line

All Anthropic skills →More docs skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by Anthropic, published under Apache-2.0. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.