skills.rest
chloebrett
chloebrettCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

claude-md-improver

Analyze CLAUDE.md files for quality and generate improvement reports.

3|Updated May 3, 2026
Search Tags:#documentation#markdown#guidelines#project docs#quality audit
One-click install
npx skills add https://github.com/chloebrett/slay --skill claude-md-improver-chloebrett
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/chloebrett/slay/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/claude-md-management/skills/claude-md-improver
Command: npx skills add https://github.com/chloebrett/slay --skill claude-md-improver-chloebrett

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill helps maintain high-quality CLAUDE.md documentation across codebases by auditing, evaluating, and improving them for accuracy and completeness.

Core Features & Use Cases

  • Discovery: Finds all CLAUDE.md files in specified project directories.
  • Assessment: Evaluates quality based on documented rubrics for commands, architecture, patterns, and currency.
  • Reporting: Generates detailed quality reports highlighting issues and improvement areas.
  • Updating: Can make targeted edits to CLAUDE.md files after user approval, focusing on actionable and project-specific info.

Quick Start

Run the Skill to find all CLAUDE.md files and generate a quality assessment report before applying any 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 CLAUDE.md documentation files for accuracy and completeness?▼

You can update multiple CLAUDE.md files by running the Skill to discover them, evaluating quality, and approving targeted edits. The Skill focuses on making actionable, project-specific improvements to enhance developer onboarding context.

What does a quality assessment report for project docs include?▼

A quality assessment report for project docs includes evaluations of consistency, accuracy, and completeness based on standardized rubrics. It highlights specific issues in commands, architecture, patterns, and currency to guide documentation improvements.

Can I automatically update markdown guidelines in repository documentation?▼

Yes, you can automatically update markdown guidelines by running the Skill to assess documentation files and apply targeted edits. After user approval, it updates relevant sections with precise, concise improvements for better project context.

When should I improve CLAUDE.md files for developer onboarding?▼

You should improve CLAUDE.md files for developer onboarding when project context is inaccurate or incomplete. The Skill evaluates documentation against rubrics and applies targeted updates to ensure actionable, project-specific information for new developers.

Related Skills

Explore More Content & Communication Skills→
breakingcircuits1337breakingcircuits1337

claude-md-improver

Audit, assess, and improve CLAUDE.md files in a repository.

Community
Intermediate
onelee85onelee85

claude-md-improver

Audit CLAUDE.md files and apply approved improvements across repositories.

Community
Advanced
lehuuhau1231lehuuhau1231

lint-and-validate

Run linting and type checking across multiple programming ecosystems.

Community
Intermediate
Mahaboob26Mahaboob26

markdown-documentation

Create structured Markdown documentation with GitHub Flavored Markdown formatting.

Community
Basic