claude-md-improver – Audit și îmbunătățire CLAUDE.md
Ce face
Skill-ul claude-md-improver scanează un repository, găsește toate fișierele CLAUDE.md, .claude.md sau .claude.local.md și le evaluează calitatea. Compară conținutul cu criterii clare (comenzi de build/test, structură de arhitectură, pattern-uri non-evidente, concizie, actualitate și acționabilitate) și atribuie un scor de la A la F. După ce-ți arată un raport detaliat, cere aprobarea ta și apoi face update-uri țintite cu tool-urile Read, Glob, Grep, Bash și Edit.
Când îmi folosește
Îl folosești când vrei să verifici sau să repari memoria de proiect a lui Claude Code. E util la onboarding pe un repo nou, după refactorizări mari, când ai impresia că Claude „nu mai ține minte” regulile proiectului sau când vrei să unifici documentația într-un monorepo. De asemenea, apare automat când spui „CLAUDE.md maintenance” sau „project memory optimization”.
Cum îl invoc / declanșez
Pur și simplu ceri în conversație: „check CLAUDE.md”, „audit CLAUDE.md files”, „update CLAUDE.md” sau „fix CLAUDE.md”. Skill-ul pornește automat faza de discovery cu comanda find, evaluează fiecare fișier și oprește la raport. Nu rulează update-uri fără confirmarea ta explicită.
Exemplu practic
Utilizator: „Poți să faci un audit la CLAUDE.md din repo-ul ăsta?”
Skill-ul:
- Găsește
./CLAUDE.mdși./packages/api/CLAUDE.md. - Le evaluează și afișează raportul cu scoruri (ex: root 82/100, api 61/100).
- Întreabă: „Vrei să corectez secțiunile lipsă de comenzi și să adaug note despre monorepo?”
- După „da”, aplică edit-urile cu Edit tool.
Output / unde aterizează
Primele output-uri sunt întotdeauna text: un tabel cu summary (fișiere găsite, scor mediu, fișiere ce necesită update) și apoi un tabel detaliat per fișier cu breakdown pe criterii. După aprobare, skill-ul scrie direct în fișierele CLAUDE.md respective. Modificările sunt locale până le comiți tu.
Limite / gotchas
Nu atinge fișierele ~/.claude/CLAUDE.md globale fără să-i spui explicit. Nu face update-uri fără raport prealabil și fără OK-ul tău. Dacă un fișier e foarte vechi sau gol, skill-ul îl marchează F și propune un schelet minim, dar nu îl rescrie complet fără confirmare. Pentru comenzi exacte de invocare sau configurări avansate, verifică doctrina pentru detalii exacte.