claudemd-optimizer

Diagnose CLAUDE.md files with a five-dimension scoring system.

1|Updated Feb 2, 2026

Search Tags:#templates #documentation #diagnosis #best-practices #claude-code #claudemd-optimizer

Ready to run

npx skills add https://github.com/jiamizhongshifu/claudemd-optimizer --skill claudemd-optimizer-jiamizhongshifu

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: claudemd-optimizer
Source: https://github.com/jiamizhongshifu/claudemd-optimizer/tree/main
Command: npx skills add https://github.com/jiamizhongshifu/claudemd-optimizer --skill claudemd-optimizer-jiamizhongshifu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

CLAUDE.md quality and consistency issues are addressed by diagnosing and optimizing CLAUDE.md to reduce Claude's error rate. This skill helps diagnose your CLAUDE.md with a five-dimension scoring system, generate project-specific templates, and provide actionable best-practices guidance.

Core Features & Use Cases

Diagnose CLAUDE.md with a five-dimension score (Completeness, Specificity, Experience Log, Structure, Tool Integration) and deliver actionable improvements.
Generate templates for seven project types: Universal, Frontend, Backend, Fullstack, CLI Tool, Content Creation, Data Analysis.
Iterate by letting Claude write rules for itself after mistakes, maintaining notes and MCP configuration for ongoing improvement.
Reference the included best-practices and templates to improve CLAUDE.md quality.

Quick Start

Ask Claude to diagnose my CLAUDE.md and generate a prioritized optimization plan.

Frequently Asked Questions about claudemd-optimizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I diagnose my CLAUDE.md file to lower Claude's error rate?▼

Diagnosing CLAUDE.md involves evaluating it across five dimensions: Completeness, Specificity, Experience Log, Structure, and Tool Integration, to generate actionable improvement recommendations that reduce Claude's error rate.

What are the best practices for writing CLAUDE.md rules for different project types?▼

Best practices for writing CLAUDE.md rules include using structured templates tailored to seven project types: Universal, Frontend, Backend, Fullstack, CLI Tool, Content Creation, and Data Analysis, ensuring project-specific guidance.

Can I use Claude to write its own CLAUDE.md rules after making mistakes?▼

Yes, you can iterate by letting Claude write rules for itself after mistakes, maintaining notes and MCP configuration to continuously improve CLAUDE.md documentation over time.

Does CLAUDE.md optimization integrate with MCP and skills for automated guidance?▼

CLAUDE.md optimization integrates with MCP and skills to provide automated guidance, using clearly defined evaluation criteria to assess and refine your documentation structure and tool integration.

What does a five-dimension CLAUDE.md score evaluate?▼

A five-dimension CLAUDE.md score evaluates Completeness, Specificity, Experience Log, Structure, and Tool Integration, providing a structured assessment to identify gaps and deliver prioritized optimization actions.