README Doctor
Rúbrica de README de 9 puntos con lista de tareas P0/P1/P2, citada con evidencia y consciente de la categoría/audiencia.
Funciona con configuración
Qué hace
Audita un README contra una rúbrica de 9 criterios (presencia de héroe, longitud de instalación a primer éxito, la frase 'qué es esto', coincidencia de jerga de audiencia, escaneabilidad, señales de deriva como versiones obsoletas y proliferación de insignias, superficie de contribución) ponderada por la categoría inferida del repositorio y la audiencia, luego genera una lista de tareas priorizada con evidencia citada por línea. Se activa con solicitudes para auditar, revisar o diagnosticar por qué un README no está funcionando; explícitamente no reescribe prosa ni valida sintaxis markdown.
Informe de la prueba
La Sección 1.1 ('operating mode') y el paso de apertura de PR en la Fase 4 dicen 'igual que repo-visuals' sin definir los modos en línea — repo-visuals vive en un plugin separado (plugins/repo-visuals) no incluido con readme-doctor, por lo que una instalación literal carece de esa pieza; la rúbrica de auditoría central de 9 puntos en sí misma es completamente autocontenida y produjo una lista de tareas nítida, citada con evidencia y priorizada en un README de prueba.
Probado el: 2026-07-15 · Claude Code 2.x (agent harness)
Instalación
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
Comandos y prompts de ejemplo
/readme-doctorRúbrica de README de 9 puntos con lista de tareas P0/P1/P2, citada con evidencia y consciente de la categoría/audiencia.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
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