How does this skill handle large documentation files?

It implements progressive disclosure, suggesting that you move long, detailed documentation into separate files within the .claude/rules/ directory to save main context space.

Can I choose between seeing suggestions or applying them automatically?

Yes, the skill supports both 'Suggest mode' for manual review of improvements and 'Apply mode' for direct editing of the CLAUDE.md file.

What is a CLAUDE.md file?

A CLAUDE.md file is a project-specific guide used by Claude Code to understand your local tech stack, preferred coding patterns, and common development commands.

Why is optimizing CLAUDE.md important?

Optimizing ensures the file remains under the 40,000 token limit and provides high-signal instructions, which reduces errors and leaves more room for code context.

Does it check for security vulnerabilities?

Yes, the optimizer specifically audits for high-priority security issues like the presence of API keys, credentials, or other sensitive data that shouldn't be in project documentation.

CLAUDE.md Best Practices Optimizer

Name: CLAUDE.md Best Practices Optimizer
Author: Goodsmileduck

byGoodsmileduck

0•

Productivity & Workflow

Optimizes project-specific CLAUDE.md files to improve AI context efficiency and task accuracy following Anthropic's official guidelines.

The CLAUDE.md Best Practices Optimizer is a specialized utility designed to audit and refine your project's configuration for Claude Code. By analyzing existing CLAUDE.md files against a rigorous checklist, it identifies anti-patterns such as verbosity, generic advice, and security risks like hardcoded credentials. The skill provides actionable scores and prioritized recommendations to ensure your instructions remain under the 40k token limit through progressive disclosure and concise, command-focused formatting. This ensures Claude has the most relevant, high-signal information needed to navigate your codebase effectively while maximizing the remaining context window for active development tasks.

Key Features

01Detailed scoring system for structure, conciseness, and specificity.

02Conversion of verbose explanations into actionable project-specific commands.

03Detection and removal of generic anti-patterns and sensitive information.

04Token usage optimization through progressive disclosure recommendations.

05Automated auditing against Anthropic's official CLAUDE.md best practices.

060 GitHub stars

Use Cases

01Auditing project documentation to move detailed rules into a modular .claude/rules structure.

02Refining an existing CLAUDE.md that has become too long or ineffective for Claude Code.

03Initializing a new project configuration to ensure high-signal AI instructions from day one.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add goodsmileduck/goodsmileduck-claude-registry claude-md-optimizer

For use in Claude.ai and ChatGPT

Download Skill