claude-md-improver

Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".

Invalid

This skill can't be scored yet

Validation errors are blocking scoring. Review and fix them to unlock Quality, Impact and Security scores. See what needs fixing →

Evaluation results

100%

65%

CLAUDE.md Documentation Audit

Quality report format and scoring

Criteria

Without context

With context

Report heading

60%

100%

Summary section

100%

Numerical score

100%

Letter grade

100%

Commands/Workflows criterion

40%

100%

Architecture Clarity criterion

100%

Non-Obvious Patterns criterion

100%

Conciseness criterion

100%

Currency criterion

100%

Actionability criterion

100%

Issues section present

100%

Stale command flagged

100%

Missing file reference flagged

100%

Improve Project Documentation for AI Sessions

Targeted CLAUDE.md updates with diff format

Criteria

Without context

With context

Report before edits

100%

Diff file header

50%

100%

Diff additions shown

100%

Why explanation

100%

Generic advice removed

100%

Verbose sections removed or condensed

100%

Generic advice flagged as issue

100%

Project-specific commands added

100%

Environment variable documented

100%

Concise additions

100%

Existing structure preserved

100%

DB import ordering gotcha

100%

78%

Monorepo Documentation Health Check

Multi-file discovery and monorepo audit

Criteria

Without context

With context

Discovery bash command

All three files assessed

100%

File type identification

70%

100%

Per-file numerical scores

100%

Duplicate content flagged

100%

Outdated architecture flagged

100%

53%

Broken file references flagged

100%

Currency criterion assessed

87%

100%

Issues per file

71%

100%

Repository: anthropics/claude-plugins-official
Commit: 48aa435

Evaluated: about 1 month ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

CLAUDE.md Documentation Audit Improve Project Documentation for AI Sessions Monorepo Documentation Health Check

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.