What is a CLAUDE.md file?

A CLAUDE.md file is a project-specific guide that provides Claude Code with essential context such as build commands, architecture notes, and coding patterns to improve its performance.

Does this skill overwrite my existing documentation automatically?

No, the skill performs a discovery and audit phase first, presenting a detailed quality report and requesting user approval before making any targeted updates.

Can this skill handle monorepos?

Yes, it is designed to discover and audit CLAUDE.md files across the entire directory tree, including package-specific files in monorepo setups.

What criteria does the skill use to score documentation?

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

Does it support local or personal configurations?

Yes, it recognizes .claude.local.md for personal settings and global defaults in the user's home directory to ensure a comprehensive context audit.

CLAUDE.md Project Optimizer

Name: CLAUDE.md Project Optimizer
Author: mattermost

bymattermost

•

学習とドキュメンテーション

Audits, evaluates, and updates CLAUDE.md files to provide Claude Code with optimal project context and actionable workflow instructions.

The claude-md-improver skill automates the maintenance of CLAUDE.md files, ensuring your repository provides the necessary context for high-performance AI-driven development. It scans your entire codebase—including monorepos and local overrides—to evaluate documentation quality against professional standards for command accuracy, architectural clarity, and actionable patterns. By generating detailed quality reports and proposing targeted, minimal updates, this skill ensures Claude Code always has a sharp, up-to-date 'memory' of your project, leading to more accurate code generation and more efficient troubleshooting.

主な機能

01Automated discovery of root, local, and package-specific context files

021 GitHub stars

03Detailed quality reports with specific, actionable improvement recommendations

04Full support for monorepo structures with nested context auditing

05Targeted documentation updates that focus on non-obvious patterns and workflows

06Comprehensive quality scoring based on command accuracy and architectural clarity

ユースケース

01Onboarding Claude Code to a new or legacy repository without existing context files

02Auditing project documentation to fix broken or stale build/test command references

03Optimizing AI 'memory' in large repositories to improve task performance and accuracy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mattermost/mattermost-ai-marketplace claude-md-improver

For use in Claude.ai and ChatGPT

Download Skill