skills.rest
ghoshsam
ghoshsamCOMMUNITY
Explore all skills by this author →
GitHub

claude-md-improver

Audit and improve CLAUDE.md files with quality scoring and targeted updates.

2|Updated Mar 21, 2026
Search Tags:#code quality#documentation#claude code#audit#monorepo#claude.md#project context
One-click install
npx skills add https://github.com/ghoshsam/claude-code-skills --skill claude-md-improver-ghoshsam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/ghoshsam/claude-code-skills/tree/main/skills/claude-md-management/claude-md-improver
Command: npx skills add https://github.com/ghoshsam/claude-code-skills --skill claude-md-improver-ghoshsam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? CLAUDE.md files often become stale, incomplete, or missing key commands, causing Claude Code to lack the project context it needs to work effectively. This Skill scans every CLAUDE.md file in a repository, grades each one against quality criteria, and applies targeted improvements after your approval. ## Core Features & Use Cases - Repository-wide discovery: Finds all CLAUDE.md variants including project root files, local overrides, global defaults, and package-level files in monorepos. - Structured quality scoring: Grades each file A through F across criteria like commands, architecture clarity, currency, and actionability, then outputs a file-by-file report. - Approval-gated updates: Proposes minimal, diff-formatted additions and only edits files after you confirm. - Use Case: After a major refactor, run an audit to catch stale build commands, missing environment setup notes, and undocumented gotchas before they confuse future sessions. ## Quick Start Ask the assistant to audit and improve all CLAUDE.md files in this repository and show a quality report first.

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 in my repository?▼

Invoke the skill and it runs a find command to locate all CLAUDE.md, .claude.md, and .claude.local.md files, then evaluates each against quality criteria and outputs a scored report before making any changes.

What makes a good CLAUDE.md file for Claude Code?▼

A good CLAUDE.md is concise, human-readable, and contains copy-paste-ready commands for build, test, and dev workflows. It should document architecture, non-obvious gotchas, and environment setup rather than generic advice.

Does the skill modify CLAUDE.md files automatically?▼

No. It always outputs a quality report first, then proposes targeted additions as diffs with explanations. Changes are applied with the Edit tool only after you explicitly approve them.

Can it handle monorepos with multiple CLAUDE.md files?▼

Yes. It discovers package-specific CLAUDE.md files in nested directories and assesses each one individually, since Claude Code auto-discovers context files in parent directories.

What is the difference between CLAUDE.md and .claude.local.md?▼

CLAUDE.md at the project root is checked into git and shared with the team, while .claude.local.md holds personal settings that should be gitignored. Global defaults live in ~/.claude/CLAUDE.md.

Related Skills

Explore More Software Engineering Skills→
cardinalconseilscardinalconseils
3

cicd-starter

Bootstrap existing codebases for the Claude Code lifecycle with CLAUDE.md and PRD initialization.

Community
Advanced
app-vitalsapp-vitals
9

learning-capture

Capture durable learnings and route them to the correct memory home.

Official
Advanced
sammcjsammcj
155

claude-md-authoring

Create CLAUDE.md files with XML-style sections documenting non-obvious codebase context.

Community
Basic
nnkiennnnkienn
1

documentation-templates

Generate README, API, code comment, and AI-friendly documentation templates.

Community
Intermediate