SkillProof tested Claude skills

README Doctor

9-punkts README-rubrikk med P0/P1/P2 punch list, bevis-siterte og kategori/målgruppe-bevisste.

av livlign · livlign/claude-skills

Krever oppsett ★ 8.4/10

README Doctor — 9-punkts README-rubrikk med P0/P1/P2 punch list, bevis-siterte og kategori/målgruppe-bevisste.

Hva den gjør

Reviderer en README mot en 9-kriterie rubrikk (hero-tilstedeværelse, installasjon-til-første-suksess-lengde, 'hva er dette'-setningen, målgruppe-jargon-match, skannbarhet, driftssignaler som utdaterte versjoner og badge-sprawl, bidragsflate) vektet etter avledet repo-kategori og målgruppe, deretter utgir en prioritert punch list med linje-siterte bevis. Utløses ved forespørsler om å revidere, gjennomgå eller diagnostisere hvorfor en README ikke lander; omskriver eksplisitt ikke prosa eller lint markdown-syntaks.

Testrapport

Seksjon 1.1 ('operating mode') og PR-åpningstrinnet i Fase 4 sier begge 'samme som repo-visuals' uten å definere modusene inline — repo-visuals lever i en separat plugin (plugins/repo-visuals) som ikke er bundlet med readme-doctor, så en ordrett installasjon mangler den delen; selve kjerne 9-punkts revisjonsrubrikken er fullstendig selvstendig og produserte en skarp, bevis-siterte, prioritert punch list på en test-README.

Testet på: 2026-07-15 · Claude Code 2.x (agent harness)

Installer

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

Kommandoer og eksempelprompter

  • /readme-doctor9-punkts README-rubrikk med P0/P1/P2 punch list, bevis-siterte og kategori/målgruppe-bevisste.

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

  • 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

Full rapport →