What is a CLAUDE.md file?

CLAUDE.md is a project-specific instruction file that provides Claude Code with essential context about your development environment, commands, and coding conventions.

Can this skill identify specific errors in my documentation?

Yes, it uses a knowledge base of anti-patterns to detect issues like embedded file content, narrative paragraphs, or redundant tool instructions.

What are the essential sections of a good CLAUDE.md?

A highly effective file should include a project overview, compact directory tree, development commands, non-obvious conventions, and resource pointers.

Why is the 100-200 line limit important?

Keeping the file concise saves context tokens and prevents the AI from becoming overwhelmed with information, leading to faster and more accurate responses.

How does it help with large monorepos?

It scans for both root and nested CLAUDE.md files, ensuring that each sub-project has the correct localized context for the AI.

CLAUDE.md Optimizer

Name: CLAUDE.md Optimizer
Author: duyet

byduyet

0•

学习与文档

Analyzes and refines CLAUDE.md files to maximize AI context efficiency and project comprehension for Claude Code.

The CLAUDE.md Optimizer is a specialized tool designed to audit and enhance the core documentation file that guides Claude Code's behavior within your repository. By analyzing your codebase's structure, tech stack, and existing instructions, the skill identifies documentation anti-patterns, redundant content, and missing essential sections. It provides an effectiveness score and actionable recommendations based on industry best practices—such as progressive disclosure and declarative styling—ensuring your AI assistant has precisely the context it needs without wasting valuable token space.

主要功能

01Comprehensive audit for documentation anti-patterns

02Automated generation of optimized CLAUDE.md drafts

03Automated codebase discovery and tech stack detection

04Line-by-line improvement recommendations and quick wins

05Effectiveness scoring based on a 1-10 expert rubric

060 GitHub stars

使用场景

01Onboarding Claude Code to a new repository with a high-performance documentation structure

02Standardizing documentation conventions across a multi-repo organization

03Improving AI accuracy by pruning bloated or redundant project instructions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add duyet/claude-plugins claude-md-optimizer

For use in Claude.ai and ChatGPT

Download Skill