CLAUDE.md Optimizer

A Claude Code skill that helps you create and optimize effective CLAUDE.md files, significantly reducing Claude's error rate.

English | 中文

English

What is this?

CLAUDE.md Optimizer is a skill for Claude Code that helps you:

• Diagnose your existing CLAUDE.md with a 5-dimension scoring system
• Optimize with actionable suggestions (must-fix / should-improve / nice-to-have)
• Generate project-specific templates (7 types: frontend, backend, fullstack, CLI, content creation, data analysis)
• Iterate by letting Claude write rules for itself after every mistake

Core Philosophy

"Invest in your CLAUDE.md. After every correction, end with: 'Update your CLAUDE.md so you don't make that mistake again.' Claude is eerily good at writing rules for itself."
— Boris (Creator of Claude Code)

Installation

Copy the claudemd-optimizer folder to your Claude Code skills directory:

# Global installation (available in all projects)
cp -r claudemd-optimizer ~/.claude/skills/

# Or project-level installation
cp -r claudemd-optimizer .claude/skills/

Usage

Trigger the skill with natural language:

"Optimize my CLAUDE.md"
"Check my CLAUDE.md"
"Help me write a CLAUDE.md"
"CLAUDE.md best practices"

Scoring Dimensions

Project Templates

• Universal - Basic framework for any project
• Frontend - React/Vue/Next.js projects
• Backend - Node.js/Python API projects
• Fullstack - Integrated frontend + backend
• CLI Tool - Command-line applications
• Content Creation - Writing, docs, blogs
• Data Analysis - Data processing projects

File Structure

claudemd-optimizer/
├── SKILL.md                 # Main skill definition
└── references/
    ├── best-practices.md    # Writing guidelines
    ├── templates.md         # Project templates
    └── checklist.md         # Evaluation checklist

中文

这是什么？

CLAUDE.md Optimizer 是一个 Claude Code 技能，帮助你：

• 诊断 现有 CLAUDE.md，提供 5 维度评分
• 优化 输出可执行的建议（必须修复 / 建议改进 / 可选增强）
• 生成 项目定制化模板（7 种类型：前端、后端、全栈、CLI、内容创作、数据分析）
• 迭代 让 Claude 在每次犯错后为自己写规则

核心理念

"投资你的 CLAUDE.md。每次纠正后，以这句话结尾：'更新你的 CLAUDE.md，这样你就不会再犯同样的错误了。' Claude 非常擅长为自己写规则。"
— Boris（Claude Code 创始人）

安装

将 claudemd-optimizer 文件夹复制到 Claude Code skills 目录：

# 全局安装（所有项目可用）
cp -r claudemd-optimizer ~/.claude/skills/

# 或项目级安装
cp -r claudemd-optimizer .claude/skills/

使用方法

用自然语言触发：

"优化我的 CLAUDE.md"
"检查一下 CLAUDE.md"
"帮我写 CLAUDE.md"
"CLAUDE.md 最佳实践"

评分维度

项目模板

• 通用模板 - 任何项目的基础框架
• 前端项目 - React/Vue/Next.js 等
• 后端项目 - Node.js/Python API 等
• 全栈项目 - 前后端一体化
• CLI 工具 - 命令行工具项目
• 内容创作 - 写作、文档、博客
• 数据分析 - 数据处理项目

文件结构

claudemd-optimizer/
├── SKILL.md                 # 主技能定义
└── references/
    ├── best-practices.md    # 编写指南
    ├── templates.md         # 项目模板
    └── checklist.md         # 检查清单

Contributing

Issues and PRs are welcome!

License

MIT License - see LICENSE for details.

Acknowledgments

• Inspired by tips from the Claude Code team
• Based on real-world experience optimizing CLAUDE.md files