refactor-claude-md
FeaturedUse when refactoring a user-level or project-level CLAUDE.md for progressive disclosure
AI & Automation 129 stars
25 forks Updated today MIT
Install
Quality Score: 93/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://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-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 l...
Details
- Author
- vinta
- Repository
- vinta/hal-9000
- Created
- 10 years ago
- Last Updated
- today
- 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-authoring
Author a lean, runnable CLAUDE.md (or AGENTS.md). Only universal instructions; defer detail to docs; push style to linters and certainties to hooks. Use when writing or auditing a project CLAUDE.md.
0 Updated today
voidcorp-core AI & Automation Featured
refactor-agents-md
Use when refactoring a user-level or project-level AGENTS.md for progressive disclosure
129 Updated today
vinta AI & Automation Listed
claude-md-boost
Optimize project CLAUDE.md — expert prompt engineering + stack best practices
0 Updated yesterday
Vleickzs