CLAUDE.md Improver
Audit CLAUDE.md files against the current codebase and propose concise, targeted improvements. This is an OpenCode-compatible adaptation of Anthropic's claude-md-management plugin skill.
Workflow
- Discover
CLAUDE.md, .claude.md, and .claude.local.md files with Glob. Include root, package, and nested instruction files.
- Inspect the repository's manifests, scripts, tests, configuration, and architecture. Verify documented commands rather than assuming they work.
- Score each instruction file from 0 to 100 using these criteria:
- Commands and workflows: 20
- Architecture clarity: 20
- Non-obvious patterns and gotchas: 15
- Conciseness: 15
- Currency: 15
- Actionability: 15
- Present a quality report before editing. For every file, include its score, specific issues, and recommended additions or removals.
- Show a focused diff and ask for approval before changing any instruction file.
- Apply only approved changes while preserving the existing structure and voice.
Update Rules
- Add project-specific commands, architecture, testing patterns, environment requirements, and recurring gotchas.
- Remove stale or contradicted guidance.
- Keep each concept as short as practical because instruction files consume context.
- Do not add generic best practices, obvious facts, one-off fixes, secrets, or host-specific values.
- Put shared guidance in
CLAUDE.md and personal guidance in .claude.local.md.
- Never edit an instruction file before presenting the report and receiving approval.
Report Format
## CLAUDE.md Quality Report
### Summary
- Files found: X
- Average score: X/100
- Files needing updates: X
### ./CLAUDE.md
**Score: XX/100 (Grade: X)**
| Criterion | Score | Notes |
|---|---:|---|
| Commands and workflows | X/20 | ... |
| Architecture clarity | X/20 | ... |
| Non-obvious patterns | X/15 | ... |
| Conciseness | X/15 | ... |
| Currency | X/15 | ... |
| Actionability | X/15 | ... |
**Issues:** ...
**Recommended changes:** ...
Use grades A for 90-100, B for 70-89, C for 50-69, D for 30-49, and F below 30.
1---2name: claude-md-improver3description: Audit and improve CLAUDE.md project instructions. Use when the user asks to check, audit, update, improve, or maintain CLAUDE.md files or project memory.4---56# CLAUDE.md Improver78Audit CLAUDE.md files against the current codebase and propose concise, targeted improvements. This is an OpenCode-compatible adaptation of Anthropic's `claude-md-management` plugin skill.910## Workflow11121. Discover `CLAUDE.md`, `.claude.md`, and `.claude.local.md` files with Glob. Include root, package, and nested instruction files.132. Inspect the repository's manifests, scripts, tests, configuration, and architecture. Verify documented commands rather than assuming they work.143. Score each instruction file from 0 to 100 using these criteria:15 - Commands and workflows: 2016 - Architecture clarity: 2017 - Non-obvious patterns and gotchas: 1518 - Conciseness: 1519 - Currency: 1520 - Actionability: 15214. Present a quality report before editing. For every file, include its score, specific issues, and recommended additions or removals.225. Show a focused diff and ask for approval before changing any instruction file.236. Apply only approved changes while preserving the existing structure and voice.2425## Update Rules2627- Add project-specific commands, architecture, testing patterns, environment requirements, and recurring gotchas.28- Remove stale or contradicted guidance.29- Keep each concept as short as practical because instruction files consume context.30- Do not add generic best practices, obvious facts, one-off fixes, secrets, or host-specific values.31- Put shared guidance in `CLAUDE.md` and personal guidance in `.claude.local.md`.32- Never edit an instruction file before presenting the report and receiving approval.3334## Report Format3536```markdown37## CLAUDE.md Quality Report3839### Summary40- Files found: X41- Average score: X/10042- Files needing updates: X4344### ./CLAUDE.md45**Score: XX/100 (Grade: X)**4647| Criterion | Score | Notes |48|---|---:|---|49| Commands and workflows | X/20 | ... |50| Architecture clarity | X/20 | ... |51| Non-obvious patterns | X/15 | ... |52| Conciseness | X/15 | ... |53| Currency | X/15 | ... |54| Actionability | X/15 | ... |5556**Issues:** ...5758**Recommended changes:** ...59```6061Use grades A for 90-100, B for 70-89, C for 50-69, D for 30-49, and F below 30.
M0rtalPhe0nix