skills.rest
sunLeee
sunLeeeCOMMUNITY
Explore all skills by this author →
GitHub

claude-md-improver

Audit CLAUDE.md files against the current codebase and generate update recommendations.

Updated Mar 19, 2026
Search Tags:#documentation#codebase#audit#quality-assurance#policy#claude-md
One-click install
npx skills add https://github.com/sunLeee/optimization --skill claude-md-improver-sunleee
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/utility/claude-md-improver
Command: npx skills add https://github.com/sunLeee/optimization --skill claude-md-improver-sunleee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md drift between the documentation and current codebase policies is detected and remediation proposals are generated to maintain alignment.

Core Features & Use Cases

  • Automated auditing: compares CLAUDE.md with the latest codebase guidelines and plugin references to surface inconsistencies.
  • Update recommendations: suggests precise edits and links to relevant design docs and AW rules.
  • Maintenance support: enables periodic checks and session-driven updates via the /revise-claude-md workflow.

Quick Start

Review the latest CLAUDE.md files in the repository and run the audit to generate a report of suggested updates.

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 a CLAUDE.md file against my current codebase?▼

To audit a CLAUDE.md file, compare its documented policies and structure against the latest codebase guidelines. This process identifies drift and generates update recommendations with concrete edits and links to relevant design docs.

What causes CLAUDE.md documentation drift in a repository?▼

CLAUDE.md documentation drift occurs when codebase policies, structure, or commands change without corresponding updates to the file. Automated auditing detects these inconsistencies by comparing the documentation against current repository guidelines and plugin references.

How do I generate update recommendations for outdated codebase documentation?▼

Generating update recommendations involves running a repository-wide audit to verify alignment with AW rules and design references. This produces precise edits and links to relevant docs to remediate detected inconsistencies.

Can I run session-driven updates to fix CLAUDE.md alignment issues?▼

Yes, session-driven updates are supported via the /revise-claude-md workflow. This enables periodic checks and maintenance to apply concrete changes and verify structure alignment with current codebase policies.

Does the CLAUDE.md audit require any external dependencies or plugins?▼

No external dependencies or plugins are required to perform the CLAUDE.md audit. The process operates directly on the repository to compare file content against current codebase guidelines and design references.

Related Skills

Explore More Content & Communication Skills→
LorenFrankLabLorenFrankLab
3

safe-refactoring

Refactor code structure while preserving behavior via baseline tests and numerical equivalence.

Official
Intermediate
githubgithub
123

recompile-workflows

Regenerate and post-process agentic workflow lock files after gh-aw updates.

Official
Intermediate
billydeeii136billydeeii136

health

Compute a weighted 0-10 codebase health score and track trends over time.

Community
Intermediate
brainbrewlabsbrainbrewlabs
7

doc-review

...

Official
Intermediate