How does Gotcha Mining work?

The skill scans your codebase for patterns like FIXME, HACK, or complex platform-specific logic that isn't documented, then suggests adding these 'landmines' to your CLAUDE.md to prevent AI errors.

What is the agents-md methodology?

It is a strategy popularized by Addy Osmani that focuses on removing information AI agents can discover themselves (like file trees) and prioritizing 'human-only' knowledge like non-obvious landmines and gotchas.

Why should I remove the directory structure from my documentation?

Since Claude Code can use the 'ls' and 'glob' tools to see your folder structure instantly, including it in CLAUDE.md wastes tokens and risks providing outdated info if the structure changes.

Will this delete important information from my CLAUDE.md?

The skill only targets information that Claude can already find using its built-in tools (like Glob or Grep). It provides a classification report and asks for confirmation before any modifications are made.

Claude.md Optimizer

Name: Claude.md Optimizer
Author: CaesiumY

byCaesiumY

•

학습 및 문서화

Optimizes project instruction files by removing redundant code-discoverable data and adding high-value operational knowledge like gotchas and landmines.

The Claude.md Optimizer applies the agents-md methodology to streamline your project's CLAUDE.md file, ensuring Claude operates with maximum efficiency and minimal token waste. By filtering out information the agent can already discover through its own tools—such as directory structures or data flow diagrams—the skill reduces context noise that can degrade performance by up to 20%. It proactively scans your source code to 'mine' for undocumented landmines, platform quirks, and non-standard conventions, replacing redundant text with high-signal operational knowledge that helps Claude work faster and more accurately.

주요 기능

01Intelligent 'Gotcha Mining' via source code scanning for hidden logic constraints and platform quirks.

02Surgical editing to compress verbose documentation while preserving essential operational context.

032 GitHub stars

04Interactive approval workflow with dry-run support to prevent unintended documentation loss.

05Automated discoverability filtering to remove redundant directory structures and file maps.

06Detailed baseline analysis with line-by-line statistics and content classification reports.

사용 사례

01Migrating standard documentation to the 'agents-md' methodology for optimized AI developer experience.

02Identifying hidden project 'landmines' and undocumented conventions that frequently cause AI agents to fail.

03Reducing token usage and improving Claude's accuracy by slimming down bloated CLAUDE.md files.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add caesiumy/dding-dong claude-md-optimizer

For use in Claude.ai and ChatGPT

주요 기능

01Intelligent 'Gotcha Mining' via source code scanning for hidden logic constraints and platform quirks.

02Surgical editing to compress verbose documentation while preserving essential operational context.

032 GitHub stars

04Interactive approval workflow with dry-run support to prevent unintended documentation loss.

05Automated discoverability filtering to remove redundant directory structures and file maps.

06Detailed baseline analysis with line-by-line statistics and content classification reports.

사용 사례

01Migrating standard documentation to the 'agents-md' methodology for optimized AI developer experience.

02Identifying hidden project 'landmines' and undocumented conventions that frequently cause AI agents to fail.

03Reducing token usage and improving Claude's accuracy by slimming down bloated CLAUDE.md files.