refactor-claude-md
FeaturedUse when refactoring a user-level or project-level CLAUDE.md for progressive disclosure
AI & Automation 120 stars
21 forks Updated yesterday MIT
Install
Quality Score: 92/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Overview
Refactor a CLAUDE.md toward progressive disclosure. Every line it keeps is loaded into every session the file covers, and a frontier model follows only around 150 to 200 standing instructions consistently, so each line competes for that budget. Everything else moves down the ladder or out of the file.
## Instructions
1. **Pick the target.** If the invocation names one, use it. Otherwise ask with `AskUserQuestion`, one option per file that exists, with the resolved path in the label:
- The user-level CLAUDE.md at `~/.claude/CLAUDE.md`
- The current project's CLAUDE.md
2. **Fetch the yardsticks.** Fetch these pages. They calibrate the delete and rewrite verdicts below:
- https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices
- https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5
- https://www.aihero.dev/a-complete-guide-to-agents-md
3. **Audit.** Read the file and give every instruction exactly one verdict, judged against the target's bar below. Done when no instruction lacks one.
- **contradiction**: conflicts with another instruction. Record both sides.
- **delete**: fails the no-op test, meaning the agent would behave the same without it. Covers instructions the agent already follows by default, instructions too vague to act on, and platitudes like "write clean code".
- **demote**: real instruction that only applies to some paths or tasks. Pi...
Details
- Author
- vinta
- Repository
- vinta/hal-9000
- Created
- 10 years ago
- Last Updated
- yesterday
- Language
- Python
- License
- MIT
Integrates with
Bundled in these plugins
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
claude-md-boost
Optimize project CLAUDE.md — expert prompt engineering + stack best practices
0 Updated today
Vleickzs AI & Automation Solid
refactor-agents-md
Use when refactoring a user-level or project-level AGENTS.md for progressive disclosure
120 Updated yesterday
vinta AI & Automation Listed
claude-md-optimizer
Analyzes and optimizes CLAUDE.md files following Anthropic's official best practices. Use when reviewing existing CLAUDE.md for improvements, or when user mentions CLAUDE.md is too long or ineffective.
1 Updated 1 weeks ago
Goodsmileduck