README Doctor
9-punktowa rubryka README z listą kontrolną P0/P1/P2, popartą dowodami i uwzględniającą kategorię/odbiorcę.
Działa po konfiguracji
Co robi ten skill
Audytuje README pod kątem 9-kryterialnej rubryki (obecność bohatera, długość instalacji do pierwszego sukcesu, zdanie 'co to jest', dopasowanie żargonu do odbiorcy, skanowalność, sygnały dryfu, takie jak przestarzałe wersje i nadmiar odznak, powierzchnia wkładu) ważonej według wywnioskowanej kategorii repozytorium i odbiorcy, a następnie generuje priorytetową listę kontrolną z dowodami cytowanymi w wierszach. Reaguje na żądania audytu, przeglądu lub diagnozy, dlaczego README nie działa; wyraźnie nie przepisuje prozy ani nie sprawdza składni markdown.
Raport z testu
Sekcja 1.1 ('operating mode') i krok otwarcia PR w Fazie 4 mówią 'same as repo-visuals' bez definiowania trybów w linii — repo-visuals znajduje się w oddzielnym pluginie (plugins/repo-visuals) niezaładowanym z readme-doctor, więc dosłowna instalacja brakuje tego elementu; sama podstawowa 9-punktowa rubryka audytu jest w pełni samodzielna i wygenerowała ostrą, popartą dowodami, priorytetową listę kontrolną dla testowego README.
Testowano: 2026-07-15 · Claude Code 2.x (agent harness)
Instalacja
git clone https://github.com/livlign/claude-skills cd claude-skills mkdir -p ~/.claude/skills cp -r plugins/repo-doctor/skills/readme-doctor ~/.claude/skills/readme-doctor
Komendy i przykładowe prompty
/readme-doctor9-punktowa rubryka README z listą kontrolną P0/P1/P2, popartą dowodami i uwzględniającą kategorię/odbiorcę.
Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):
why isn't my README landing with new visitors, what's missingaudit this README and give me a prioritized list of fixesdoes my project's README explain what it does fast enough