What happens if I don't have a CLAUDE.md yet?

The skill enters 'New Creation Mode,' scans your package managers and directory structure, and generates a standardized file based on a best-practice template.

Why should I optimize my CLAUDE.md file?

A bloated or outdated CLAUDE.md can cause Claude to hallucinate commands or ignore critical project rules. Optimization ensures the AI has the most relevant context without wasting tokens.

How does it count the number of instructions?

It uses a specialized counting method for list items, table rows, and command blocks to ensure your file stays within the recommended budget of 100-150 effective instructions.

Does this skill support monorepos?

Yes, it specifically detects when different subdirectories require their own CLAUDE.md files due to differing tech stacks, tools, or local rules.

CLAUDE.md Optimizer

Name: CLAUDE.md Optimizer
Author: CAPHTECH

byCAPHTECH

0•

开发者工具

Optimizes and maintains project-specific CLAUDE.md files to improve Claude's instruction following and context accuracy.

CLAUDE.md Optimizer is a specialized management tool designed to keep your project's AI instructions lean, accurate, and effective. It automatically scans your codebase to identify essential scripts, test frameworks, and architectural patterns, then performs a 7-point diagnostic on existing CLAUDE.md files to detect instruction bloat, outdated commands, or missing safety constraints. By aligning written instructions with the actual code reality, this skill ensures Claude Code operates with maximum efficiency while staying within token budgets and following project-specific best practices.

主要功能

010 GitHub stars

02Template-based generation for new projects without existing configurations

03Automated project scanning to discover build, test, and linting commands

047-point best-practice analysis for existing CLAUDE.md files

05Gap detection to identify contradictions between instructions and actual code

06Smart subdirectory suggestions for complex monorepos or multi-stack projects

使用场景

01Fixing instances where Claude fails to follow specific project rules or coding styles

02Onboarding Claude Code to a new or complex legacy codebase quickly

03Performing periodic maintenance to prevent instruction drift as a project evolves

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add caphtech/claude-marketplace claude-md-optimizer

For use in Claude.ai and ChatGPT

主要功能

010 GitHub stars

02Template-based generation for new projects without existing configurations

03Automated project scanning to discover build, test, and linting commands

047-point best-practice analysis for existing CLAUDE.md files

05Gap detection to identify contradictions between instructions and actual code

06Smart subdirectory suggestions for complex monorepos or multi-stack projects

使用场景

01Fixing instances where Claude fails to follow specific project rules or coding styles

02Onboarding Claude Code to a new or complex legacy codebase quickly

03Performing periodic maintenance to prevent instruction drift as a project evolves

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add caphtech/claude-marketplace claude-md-optimizer

For use in Claude.ai and ChatGPT