What criteria does it use to score my files?

It evaluates files based on command actionability, architectural clarity, documentation of non-obvious patterns, conciseness, and currency.

Does this skill automatically change my files?

No, the skill first generates a quality report and only applies updates after you review and approve the proposed changes.

Can this skill handle monorepos?

Yes, it can discover and audit multiple CLAUDE.md files across nested directories and package-specific folders in a monorepo setup.

Why should I audit my CLAUDE.md files?

Auditing ensures the AI has accurate, up-to-date information, preventing errors caused by stale build commands or misunderstood project structures.

What is a CLAUDE.md file?

A CLAUDE.md file is a documentation file used by Claude Code to understand a project's specific commands, architecture, and coding patterns for better context.

CLAUDE.md Project Improver

Name: CLAUDE.md Project Improver
Author: astrosteveo

byastrosteveo

•

Herramientas para Desarrolladores

Audits and optimizes CLAUDE.md files to provide Claude Code with precise project context and executable workflows.

The CLAUDE.md Improver is a specialized skill designed to maintain and enhance the project memory files that guide Claude's behavior within a repository. It performs a comprehensive discovery of all CLAUDE.md variations—including root, local, and package-specific files—and evaluates them against a rigorous quality rubric covering command accuracy, architectural clarity, and actionable instructions. By generating detailed quality reports and proposing targeted updates, this skill ensures that Claude always has access to current build commands, non-obvious code patterns, and the specific domain knowledge required for high-performance coding sessions.

Características Principales

01Automated discovery of root, local, global, and package-specific CLAUDE.md files

02Detailed quality reports highlighting missing commands, stale architecture, and undocumented patterns

03Monorepo support for managing multiple package-level context files

04Comprehensive quality assessment with letter grades (A-F) based on weighted criteria

05Safe, approval-based updates using diffs to inject missing workflows and project context

061 GitHub stars

Casos de Uso

01Auditing a legacy repository to ensure Claude understands the build and test workflows

02Standardizing project documentation across a monorepo with multiple sub-packages

03Optimizing project memory to reduce AI errors caused by outdated or missing instructions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astrosteveo/marketplace claude-md-improver

For use in Claude.ai and ChatGPT

Download Skill