How does this improve Claude's performance?

By removing generic 'clean code' advice that Claude already knows and focusing on project-specific rules, you free up context space for actual coding tasks.

Why should I optimize my CLAUDE.md file?

Large or generic CLAUDE.md files consume more context tokens and can cause Claude to lose focus. Optimization ensures instructions are project-specific, keeping the model efficient and accurate.

What does the @import feature do?

It allows you to split your configuration into smaller, scoped files (like testing.md or git-workflow.md) to keep the main CLAUDE.md organized and under the 30KB recommended threshold.

Does this skill require external dependencies?

Yes, it utilizes the 'claude-code-lint' (claudelint) npm package to perform deep validation checks and file analysis.

CLAUDE.md Optimizer

Name: CLAUDE.md Optimizer
Author: pdugan20

bypdugan20

•

开发者工具

Optimizes and organizes CLAUDE.md files through automated validation, size reduction, and intelligent content splitting.

This skill provides an interactive, three-phase workflow to maintain high-quality project instructions in Claude Code. It validates CLAUDE.md files against size limits and best practices, identifies generic or redundant content, and helps restructure large files using @import patterns and scoped rules. By keeping project context concise and specific, it ensures Claude remains performant and focused on project-specific logic rather than generic coding advice, preventing context bloat and improving instruction following.

主要功能

01Detection and removal of redundant or generic coding instructions

022 GitHub stars

03Automated validation of file size, structure, and syntax

04Interactive @import file creation for modular configuration

05Quality assessment based on specificity, clarity, and maintainability

06Fixing of circular import dependencies and path issues

使用场景

01Reducing CLAUDE.md file size when hitting context window or 30KB warnings

02Transitioning a monolithic configuration into a modular, scoped @import structure

03Cleaning up legacy or generic instructions to improve AI model focus and accuracy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pdugan20/claudelint optimize-cc-md

For use in Claude.ai and ChatGPT