¿Qué hace auditar-la-lista?
Audita las secciones de README.md contra las reglas de la lista corta — vuelve a verificar el veredicto de cada entrada con datos en vivo, promueve o degrada competidores, reestructura casos de uso sobredimensionados, poda y evalúa adiciones propuestas. Actívalo cuando el mantenedor solicite auditar, barrer, podar, volver a verificar o mantener secciones, o pregunte si una entrada (o una propuesta) merece su lugar.
Comportamiento
- Auditar: Revisa todas las entradas de una sección contra las reglas. Consulta datos en vivo (estrellas, actividad, etc.) para confirmar o cambiar el veredicto.
- Barrer: Realiza una limpieza rápida: elimina enlaces rotos, proyectos archivados o inactivos.
- Podar: Reduce el tamaño de secciones sobredimensionadas moviendo entradas de baja prioridad a un archivo
archive.md. - Re-verificar: Vuelve a verificar el estado de competidores o entradas marcadas.
- Mantener: Aplica actualizaciones menores (orden alfabético, enlaces, formato).
- Evaluar: Dado un enlace o nombre de propuesta, determina si cumple los criterios para ser incluido.
Plataformas soportadas
- Claude Code
- Cursor
- Codex
Cómo invocar
Usa lenguaje natural:
- "Audita la sección de frameworks"
- "Barre el README"
- "Podar la lista de herramientas JS"
- "Revisa si tailwindcss debería estar en la lista"
- "¿Esta propuesta cumple las reglas?"
Reglas de la lista corta (ejemplo)
- Criterio de estrellas: > 1000 estrellas en GitHub (o forks equivalentes).
- Actividad: Último commit hace menos de 1 año.
- Relevancia: Debe tener una sección dedicada en el README.
- Calidad: Documentación clara, licencia open source.
La habilidad puede adaptarse a reglas personalizadas definidas en un archivo .audit-rules.yaml.
Ejemplo de flujo
# El usuario dice:
# "Audita la sección de bases de datos"
# La habilidad:
1. Carga las reglas desde `.audit-rules.yaml`
2. Analiza cada entrada de la sección "Bases de datos" en README.md
3. Consulta la API de GitHub para datos actualizados
4. Genera un informe con cambios propuestos (promocionar, degradar, eliminar)
5. Pide confirmación antes de aplicar