How does the skill decide what information to keep or remove?

It keeps project-specific architecture, essential dev commands, and non-obvious conventions while removing boilerplate or info that Claude can derive from reading the file structure.

When is the best time to run the update-claudemd skill?

Run it whenever documentation feels stale, after adding new major dependencies, or if Claude begins providing suboptimal code suggestions due to outdated project context.

Why should I use this skill instead of writing CLAUDE.md manually?

This skill applies a rigorous behavioral influence test to every line, ensuring your instructions stay concise (targeting 150-250 lines) and perfectly synchronized with the actual state of your codebase.

Does it delete my existing CLAUDE.md content?

The skill creates a CLAUDE.md.bak file before writing any changes, allowing you to easily diff the optimization and revert or merge specific sections if needed.

CLAUDE.md Optimizer

Name: CLAUDE.md Optimizer
Author: gupsammy

bygupsammy

•

学习与文档

Optimizes and synchronizes CLAUDE.md project instructions with the current state of your codebase to improve AI performance.

The update-claudemd skill automates the maintenance of the CLAUDE.md file, ensuring project-specific instructions remain concise, accurate, and impactful for Claude. It systematically explores the codebase to identify tech stacks, commands, and coding patterns while stripping away redundant information that Claude can infer independently. By enforcing a strict behavioral influence test, it reduces documentation bloat and prevents Claude from following stale or misleading instructions, ultimately improving the quality and efficiency of AI-assisted development sessions.

主要功能

01Intelligent reconciliation of commands, paths, and environment variables

02Automated codebase exploration to identify current tech stack and development patterns

03Structural optimization for better scannability and improved AI context interpretation

04Automatic backup creation of CLAUDE.md before any modifications are applied

0552 GitHub stars

06Strict behavior-based filtering to eliminate documentation bloat and redundancy

使用场景

01Cleaning up a verbose CLAUDE.md that has become too large for efficient context windows

02Syncing documentation when local dev commands or coding conventions change

03Refreshing project instructions after a major refactor or tech stack migration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gupsammy/claudest update-claudemd

For use in Claude.ai and ChatGPT

Download Skill