claude-md-improver

Discover and assess CLAUDE.md files, then propose targeted updates.

Updated Aug 23, 2026

Search Tags:#automation #documentation #codebase #monorepo #claude-md #quality-assessment #diff-generation

Ready to run

npx skills add https://github.com/PoyoPoak/FastAPI-App-Template --skill claude-md-improver-poyopoak

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/PoyoPoak/FastAPI-App-Template/tree/main/.agents/skills/claude-md-improver
Command: npx skills add https://github.com/PoyoPoak/FastAPI-App-Template --skill claude-md-improver-poyopoak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md quality issues across a codebase, enabling automated discovery, evaluation, and targeted improvements to keep project context accurate for Claude-driven sessions.

Core Features & Use Cases

Discover all CLAUDE.md files in a repository (root, packages, monorepos).
Assess quality against a defined rubric and generate a structured quality report.
Propose targeted, project-specific updates to CLAUDE.md with concise diffs after user approval.
Help maintain consistency across multiple CLAUDE.md files and support maintenance workflows.

Quick Start

Run the CLAUDE.md Improver to scan your repository, generate a quality report, and apply targeted 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 and improve CLAUDE.md files across a monorepo?▼

To audit CLAUDE.md files across a monorepo, this tool enumerates all files from roots to packages, evaluates them against a quality rubric, generates a structured report, and proposes targeted diffs after approval.

What is the best way to maintain consistent project context for Claude sessions in a codebase?▼

Maintaining consistent project context requires regularly assessing CLAUDE.md documentation quality and applying targeted updates to ensure accurate information across all repository levels.

How does automated CLAUDE.md quality assessment work?▼

Automated CLAUDE.md quality assessment works by scanning the repository for documentation files, evaluating the content against a defined rubric, and outputting a structured quality report detailing necessary improvements.

Can I generate diffs for CLAUDE.md updates without manually rewriting the files?▼

Yes, you can generate diffs for CLAUDE.md updates automatically; the tool proposes project-specific targeted updates and generates concise diffs for applied changes after user approval.

Does the CLAUDE.md improver support documentation maintenance for nested package structures?▼

Yes, documentation maintenance supports nested package structures by discovering and evaluating all CLAUDE.md files across roots, packages, and monorepos to ensure comprehensive quality assessment.