skills.rest
thevibeworks
thevibeworksOFFICIAL
Explore all skills by this author →
WebsiteGitHub

claude-md-improver

Audit CLAUDE.md files for completeness and apply user-approved diff updates.

28|5|Updated Jun 24, 2025
Search Tags:#markdown#claude.md#tool use#context optimization#repository audit#diff generation#monorepo maintenance
One-click install
npx skills add https://github.com/thevibeworks/claude-code-docs --skill claude-md-improver-thevibeworks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/thevibeworks/claude-code-docs/tree/main/content/github/claude-plugins-official/plugins/claude-md-management/skills/claude-md-improver
Command: npx skills add https://github.com/thevibeworks/claude-code-docs --skill claude-md-improver-thevibeworks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

CLAUDE.md files can drift out of date, become incomplete, or fail to capture the project context Claude Code needs, leading to lower-quality answers and wasted iterations.

Core Features & Use Cases

  • CLAUDE.md discovery across repositories: Finds CLAUDE.md, .claude.md, and .claude.local.md in common locations, including monorepos and nested folders.
  • Quality scoring with targeted recommendations: Evaluates each file against command coverage, architecture clarity, non-obvious gotchas, conciseness, currency, and actionability.
  • Diff-based, user-approved updates: Produces a detailed quality report first, then—only with confirmation—applies minimal, actionable edits using the Edit tool.

Quick Start

Run claude "Audit and improve the CLAUDE.md files in this repo, then show me a quality report and proposed diffs before making any changes."

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 and improve CLAUDE.md context quality in a monorepo?▼

To audit CLAUDE.md context quality, this skill discovers all file variants across your monorepo, evaluates completeness against quality criteria, and outputs a per-file quality report before applying targeted, diff-based updates upon your confirmation.

What makes a high-quality CLAUDE.md file for Claude Code context optimization?▼

A high-quality CLAUDE.md file scores well in command coverage, architecture clarity, non-obvious gotchas, conciseness, currency, and actionability, ensuring Claude Code receives the necessary project context without wasted iterations.

Can I apply context optimization to nested CLAUDE.md and .claude.local.md files?▼

Yes, context optimization applies to nested CLAUDE.md and .claude.local.md files by discovering these variants in common locations throughout multi-package repositories and evaluating them against the same quality criteria.

What's the best way to update outdated CLAUDE.md files without losing existing content?▼

The best way to update outdated CLAUDE.md files is through minimal, diff-based edits that require user confirmation before changes are applied, ensuring existing content is preserved while targeted improvements are made.

Does the CLAUDE.md audit process automatically modify repository files without approval?▼

No, the CLAUDE.md audit process does not automatically modify repository files; it produces a detailed quality report first and applies actionable edits using the Edit tool only after receiving explicit user confirmation.

Related Skills

Explore More Software Engineering Skills→
fcastrillofcastrillo

rai-discover-start

Detect project type, languages, and key directories into work/discovery/context.yaml.

Community
Intermediate
goodnessibehgoodnessibeh
1

claude-md-improver

Audit and improve CLAUDE.md files against predefined quality criteria.

Community
Advanced
InsForgeInsForge
12.7k

ui

Manage reusable UI components within the InsForge monorepo.

Official
Intermediate
DMT123DMT123

claude-md-improver

Audit CLAUDE.md files and generate quality reports with targeted updates.

Community
Intermediate