Claude md improver

Skill M0rtalPhe0nix/dotfiles/.claude/skills/claude-md-improver

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.From its SKILL.md

Install

npx -y skills add M0rtalPhe0nix/dotfiles --skill claude-md-improver

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.3 KB, 524 tokens by cl100k_base, as published. Nobody here has run it

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.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.