skills.rest
ksolomon
ksolomonCOMMUNITY
Explore all skills by this author →
Website𝕏@KeithInWpgGitHub

claude-md-improver

Audit and improve CLAUDE.md files against quality rubrics and templates.

1|Updated Jul 6, 2015
Search Tags:#code quality#documentation#claude code#audit#monorepo#claude.md#project context
One-click install
npx skills add https://github.com/ksolomon/dotfiles --skill claude-md-improver-ksolomon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/ksolomon/dotfiles/tree/main/AI/.claude/plugins/marketplaces/claude-plugins-official/plugins/claude-md-management/skills/claude-md-improver
Command: npx skills add https://github.com/ksolomon/dotfiles --skill claude-md-improver-ksolomon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? CLAUDE.md files often become stale, sparse, or filled with generic advice, leaving Claude Code without accurate project context. This Skill scans a repository for all CLAUDE.md files, scores them against a structured quality rubric, and applies targeted improvements after user approval. ## Core Features & Use Cases - Repository-wide discovery: Finds project root, local override, global, package-level, and nested CLAUDE.md files automatically. - Scored quality reports: Evaluates each file across six weighted criteria (commands, architecture, patterns, conciseness, currency, actionability) and assigns letter grades. - Targeted updates with diffs: Proposes minimal, project-specific additions shown as diffs, then applies them with the Edit tool only after confirmation. - Use Case: After a major refactor, run an audit to catch broken build commands and outdated architecture notes across a monorepo's CLAUDE.md files, then update them in one pass. ## Quick Start Audit all CLAUDE.md files in this repository and show me a quality report with recommended improvements.

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?▼

Ask Claude to audit your CLAUDE.md files and it will scan for all variants including root, .claude.local.md, and package-level files. It then scores each file against six quality criteria and outputs a graded report before suggesting any changes.

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

A good CLAUDE.md is concise, actionable, and project-specific, with copy-paste-ready commands, clear architecture notes, and documented gotchas. It should avoid generic best practices and restating information obvious from the code itself.

Does the skill update CLAUDE.md files automatically?▼

No, it always outputs a quality report first and asks for confirmation before editing. Proposed changes are shown as diffs with explanations, and updates are applied only after you approve them.

Can I use CLAUDE.md files in a monorepo setup?▼

Yes, Claude auto-discovers CLAUDE.md files in parent directories, so package-level files in a monorepo work automatically. The audit finds nested and package-specific files and evaluates each one separately.

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 and should be gitignored. Global defaults for all projects belong in ~/.claude/CLAUDE.md.

Related Skills

Explore More Software Engineering Skills→
ryantkingryantking
2

memory-management

Create and maintain repository-local CLAUDE.md files with XML-tag sections for architecture, patterns, conventions, and testing.

Community
Basic
xiaoyuge886xiaoyuge886
196

claude-md-improver

Audit CLAUDE.md files against quality rubrics and propose targeted updates.

Community
Intermediate
pgEdgepgEdge

pgedge-docs

Automate creation, review, and organization of pgEdge documentation across projects.

Official
Advanced
hamzaPixlhamzaPixl
2

claude-md

Generate or audit CLAUDE.md files by analyzing repository structure and content.

Community
Advanced