Stats
Actions
Tags
From claude-coding
Updates, refreshes, optimizes, and cleans up CLAUDE.md by exploring codebase, removing stale content, and restructuring for scannability. Use when docs are out of sync.
How this skill is triggered — by the user, by Claude, or both
Slash command
/claude-coding:update-claudemdThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Content in CLAUDE.md is justified only if it changes how Claude acts in the next session. Apply this test to every line — remove anything that does not influence behavior. Aim for 150-250 lines; favor patterns and principles over verbose documentation.
Content in CLAUDE.md is justified only if it changes how Claude acts in the next session. Apply this test to every line — remove anything that does not influence behavior. Aim for 150-250 lines; favor patterns and principles over verbose documentation.
If no CLAUDE.md exists, inform the user and begin from scratch using codebase exploration only. Otherwise, read the existing CLAUDE.md and note its line count, section structure, and any content that looks stale or duplicated. Then explore the project systematically: read configuration files (package.json, Cargo.toml, requirements.txt, etc.), map the directory structure, identify the tech stack, and note established patterns and conventions. Focus on what would change how a future Claude session works in this codebase.
Stop exploration when the major directories, tech stack, and 3-5 key patterns are identified — patterns that affect how code should be written, tested, or deployed in this project. Do not attempt exhaustive coverage.
Compare codebase reality with current documentation. Apply the governing principle to every line.
Verify that commands, paths, dependencies, and environment variables are still accurate.
The dividing line: remove content Claude would infer from reading the codebase itself; keep content that would cause errors or suboptimal behavior without explicit documentation.
Cut: code blocks duplicating source files, verbose explanations, one-time setup troubleshooting, philosophical "why this matters" sections, anything Claude can derive from file inspection.
Keep: architecture decisions, essential development commands, coding conventions, critical gotchas, non-obvious behaviors that need documentation to prevent errors.
Proceed to Step 3 when every section has been evaluated against the governing principle and all inaccurate references are corrected.
Organize into scannable sections appropriate for this project type. Common sections: project overview, development commands, architecture principles, project structure, coding conventions, and development notes. Add conditional sections (design system, database schema, environment variables) only when the project warrants them.
If the existing CLAUDE.md has content whose purpose is unclear, use AskUserQuestion to confirm before removing it.
Write the updated CLAUDE.md. Ensure scannable headers, concise actionable content, accurate reflection of the current codebase, and minimal redundancy.
A CLAUDE.md.bak backup was created automatically before this write. Inform the user it exists for diffing and suggest removing it after review.
Summarize what changed: line count before vs after, sections added or removed, and key corrections applied.
npx claudepluginhub gupsammy/claudest --plugin claude-codingCreates or updates CLAUDE.md following best practices: WHAT/WHY/HOW structure, 30-300 line limits, progressive disclosure with doc references, pointers over copies, verified commands.
Audits and improves CLAUDE.md files in repositories by scanning for them, evaluating quality against criteria, generating reports, and applying targeted updates after approval.
Audits CLAUDE.md files in repositories: discovers files via find, evaluates quality against rubrics, generates reports, and applies targeted improvements after approval.