README Doctor

9bodová README rubrika s P0/P1/P2 seznamem úkolů, s uvedenými důkazy a s ohledem na kategorii/publikum.

od livlign · livlign/claude-skills

Funguje s nastavením ★ 8.4/10

README Doctor — 9bodová README rubrika s P0/P1/P2 seznamem úkolů, s uvedenými důkazy a s ohledem na kategorii/publikum.

Co umí

Audituje README podle 9kritériové rubriky (přítomnost hrdiny, délka instalace do prvního úspěchu, věta 'co to je', shoda publika s žargonem, skenovatelnost, signály driftu jako zastaralé verze a rozrůstání odznaků, povrch příspěvků) vážené podle odvozené kategorie repozitáře a publika, poté vypíše prioritizovaný seznam úkolů s důkazy citovanými z řádků. Spouští se na požadavky na audit, revizi nebo diagnostiku, proč se README neuchytí; explicitně nepřepisuje prózu ani nelintuje markdown syntaxi.

Testovací report

Sekce 1.1 ('operating mode') a krok otevření PR ve Fázi 4 obě uvádějí 'same as repo-visuals' bez definování režimů přímo -- repo-visuals se nachází v samostatném pluginu (plugins/repo-visuals), který není součástí readme-doctor, takže doslovná instalace postrádá tento kus; samotná základní 9bodová auditní rubrika je plně soběstačná a vytvořila ostrý, důkazy podložený, prioritizovaný seznam úkolů na testovacím README.

Testováno: 2026-07-15 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /readme-doctor9bodová README rubrika s P0/P1/P2 seznamem úkolů, s uvedenými důkazy a s ohledem na kategorii/publikum.

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • why isn't my README landing with new visitors, what's missing
  • audit this README and give me a prioritized list of fixes
  • does my project's README explain what it does fast enough