¿Qué hace hekouwang-claude-skill-doctor-skill?
Agente de Skill (SKILL.md) Health Check: evalúa calidad de descripción/activación, extensión, divulgación progresiva, scripts externos, portabilidad y seguridad (sin claves codificadas), generando una tarjeta de puntuación y recomendaciones de reparación. Cero dependencias, herramienta hermana de claude-md-doctor.
¿Qué hace?
Analiza tu archivo SKILL.md y te da una calificación en seis áreas clave:
- Calidad de descripción y activación: ¿La descripción del skill es clara y correcta para que el agente la active?
- Extensión: ¿El contenido tiene el tamaño adecuado? Ni muy corto ni excesivamente largo.
- Divulgación progresiva: ¿La información se presenta de forma gradual y no toda de golpe?
- Scripts externos: ¿Los comandos y scripts están en archivos separados y no embebidos en el markdown?
- Portabilidad: ¿El skill funciona en diferentes plataformas sin cambios?
- Seguridad: ¿No hay claves API ni tokens codificados?
¿Cómo usarlo?
- Coloca tu archivo
SKILL.mden el directorio raíz del proyecto. - Ejecuta el agente con la instrucción: "Revisa mi SKILL.md".
- Recibirás una tarjeta de puntuación con notas del 1 al 10 en cada dimensión, más recomendaciones detalladas.
Ejemplo de salida
📋 Tarjeta de Puntuación - SKILL.md
━━━━━━━━━━━━━━━━━━━━━━━━━
✔️ Calidad de descripción: 8/10
✔️ Extensión: 7/10
✔️ Divulgación progresiva: 9/10
✔️ Scripts externos: 6/10
✔️ Portabilidad: 8/10
✔️ Seguridad: 10/10
━━━━━━━━━━━━━━━━━━━━━━━━━
🔧 Recomendaciones:
- Externaliza los scripts inline a archivos separados.
- Añade más contexto en la descripción para mejorar la activación.
Requisitos
- Cero dependencias: No necesita instalar nada. Funciona con cualquier agente de IA compatible (Claude Code, Cursor, Codex, etc.).
- Compatibilidad: Funciona con cualquier sistema operativo.
Notas
Esta herramienta es hermana de claude-md-doctor, que se enfoca en revisiones más profundas del archivo markdown. Ambas son complementarias.