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 today 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://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