claude-md-improver

Audit, evaluate, and update CLAUDE.md files across codebases.

Updated Aug 6, 2025
One-click install
npx skills add https://github.com/fabiano001/claude-config --skill claude-md-improver-fabiano001
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/fabiano001/claude-config/tree/main/plugins/marketplaces/claude-plugins-official/plugins/claude-md-management/skills/claude-md-improver
Command: npx skills add https://github.com/fabiano001/claude-config --skill claude-md-improver-fabiano001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md files exist in multiple places and often lack consistent quality and actionable improvements. The improver helps audit, evaluate, and update CLAUDE.md to maintain project context.

Core Features & Use Cases

  • Scans all CLAUDE.md files in a repo and evaluates quality against templates.
  • Generates a quality report and suggests targeted updates to CLAUDE.md.
  • Applies approved improvements to CLAUDE.md across the codebase to keep documentation current.

Quick Start

Create a quality report for your repository and apply improvements after user approval.

Frequently Asked Questions about claude-md-improver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit CLAUDE.md files across a monorepo?

It scans project-level, package-level, and subdirectory-level CLAUDE.md files across monorepos, evaluating quality against templates to generate a comprehensive quality report with targeted improvement suggestions.

What is the best way to update outdated CLAUDE.md documentation?

The best way to update outdated CLAUDE.md is generating a quality report to identify stale content, then applying safe, user-approved edits to keep your project context current.

Can I scan subdirectory-level CLAUDE.md files in a multi-root project?

Yes, you can scan subdirectory-level CLAUDE.md files in multi-root projects. The tool discovers and evaluates all CLAUDE.md files across your codebase, scoring their quality against standard templates.

How does CLAUDE.md quality scoring work against templates?

CLAUDE.md quality scoring works by comparing your existing project context files against predefined templates, identifying missing information, outdated content, and areas for targeted improvements.

Are CLAUDE.md edits applied automatically without user approval?

No, CLAUDE.md edits are not applied automatically. The tool ensures safe, user-approved edits by generating a quality report first, then applying targeted improvements only after you review them.