refactor-claude-md

Featured

Use when refactoring a user-level or project-level CLAUDE.md for progressive disclosure

AI & Automation 120 stars 21 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 92/100

Stars 20%
69
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

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