skills.rest
Xza85hrf
Xza85hrfCOMMUNITY
Explore all skills by this author →
GitHub

claude-md-improver

Audit CLAUDE.md files against an eight-dimension rubric and output prioritized recommendations.

Updated Feb 9, 2026
Search Tags:#documentation#audit#quality#rubric#report#claude-md
One-click install
npx skills add https://github.com/Xza85hrf/claude-code-agent-kit --skill claude-md-improver-xza85hrf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md-improver
Source: https://github.com/Xza85hrf/claude-code-agent-kit/tree/main/.claude/skills/meta/claude-md-improver
Command: npx skills add https://github.com/Xza85hrf/claude-code-agent-kit --skill claude-md-improver-xza85hrf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit CLAUDE.md quality to identify gaps, inconsistencies, and improvement opportunities across the documentation rubric and related config files.

Core Features & Use Cases

  • Comprehensive eight-dimension scoring across Project Identity, Tech Stack, Commands, Coding Rules, Context Layers, Reference Implementation, Agent Configuration, and Quality Checklist.
  • Actionable improvement guidance with top-3 recommendations and quick wins.
  • Cross-reference verification against known repo artifacts to ensure evidence-based assessment.

Quick Start

Run a fresh CLAUDE.md audit on your repository to generate a structured report with prioritized 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 my CLAUDE.md file for quality and consistency?▼

Auditing CLAUDE.md quality involves applying an eight-dimension rubric across Project Identity, Tech Stack, Commands, Coding Rules, Context Layers, Reference Implementation, Agent Configuration, and Quality Checklist to yield scores, evidence notes, and suggested fixes.

What is the CLAUDE.md documentation rubric used for?▼

The CLAUDE.md documentation rubric is a scoring framework used to identify gaps, inconsistencies, and improvement opportunities in project governance documentation by cross-referencing against known repo artifacts.

How do I get actionable improvement recommendations for my project documentation?▼

You can get actionable improvement recommendations by running a fresh CLAUDE.md audit on your repository to generate a structured report featuring top-3 recommendations and quick wins.

Can I use a CLAUDE.md audit on an existing codebase?▼

Yes, you can run a CLAUDE.md audit on an existing codebase that uses CLAUDE.md for governance, as it cross-references known repo artifacts to provide an evidence-based assessment and structured improvements.

What's the best way to find gaps in my coding rules and agent configuration?▼

The best way to find gaps in coding rules and agent configuration is to apply a structured eight-dimension audit rubric, which outputs specific scores, evidence notes, and suggested fixes for your documentation.

Related Skills

Explore More Software Engineering Skills→
az9713az9713

dark-code-suite-init

Initialize a project with dark code prevention directories, CLAUDE.md section, and baseline audit.

Community
Intermediate
manastalukdarmanastalukdar
1

devex-review

Audit developer experience and produce a DX scorecard with prioritized quick wins.

Community
Advanced
PriNovaPriNova
80

structured-doc-validate

Validate YAML artifacts for schema shape, reference integrity, and evidence quality.

Community
Advanced
Mahaboob26Mahaboob26

markdown-documentation

Create structured Markdown documentation with GitHub Flavored Markdown formatting.

Community
Basic