/ Directorio / Playground / skill-doctor
← Todos los servidores ↗ GitHub
● Comunidad marian2js ⚡ Instantáneo

skill-doctor

por marian2js · marian2js/skill-doctor

Demuestre sus habilidades de Claude antes del envío: front-matter, referencias de recursos, claridad de activación, higiene de evaluación, puntuación de 0 a 100 con gravedad.

Skill-Doctor es una CLI que escanea un paquete de habilidades local y señala problemas que perjudican la activación, la confiabilidad o la calidad. Comprueba el contenido y los metadatos de YAML, verifica que las referencias de recursos estén intactas, evalúa las descripciones de los activadores para mayor claridad y valida evals/evals.json. El resultado es una puntuación de 0 a 100 con hallazgos etiquetados según la gravedad; admite modos de texto, JSON y solo puntuación, perfecto para confirmación previa, ruta previa o activación de CI.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

skill-doctor-skill.replay ▶ listo
0/0

Instalación

Repositorio del autor · Documentación oficial de Skills de Claude

Casos de uso

Usos del mundo real: skill-doctor

Elimina tu habilidad antes de publicarla en un mercado

👤 Autoras de habilidades a punto de compartir una SKILL.md ⏱ ~15 min beginner

Cuándo usarlo: Terminaste una habilidad y quieres un pase de cordura antes de que alguien más la instale.

Requisitos previos
  • Nodo 18+ — instalación nvm 18
Flujo
  1. ejecuta el doctor
    Ejecute Skill-Doctor en la raíz de la habilidad.✓ Copiado
    → Puntuación + lista de hallazgos por gravedad
  2. Reparar elementos de alta gravedad
    Solucione primero los problemas de alta gravedad; volver a ejecutar hasta obtener una puntuación ≥ 85.✓ Copiado
    → La puntuación sube; los críticos desaparecen

Resultado: Una habilidad que se activa cuando lo esperas y no tiene referencias rotas.

Errores comunes
  • Persiguiendo un 100 perfecto — Los elementos de baja gravedad (liendres de estilo) suelen estar bien; centrarse en los desencadenantes y los recursos
Combinar con: oaustegard-claude-skills

Obtenga un repositorio de habilidades con un puntaje de calidad mínimo en CI

👤 Equipos que mantienen múltiples habilidades en un repositorio ⏱ ~30 min intermediate

Cuándo usarlo: Envías habilidades con frecuencia y quieres evitar la deriva.

Requisitos previos
  • Acciones de GitHub (o equivalente) — Repositorio con .github/workflows/
Flujo
  1. Agregar el flujo de trabajo
    Agregue un trabajo de Acciones de GH que ejecute Skill-Doctor y falle si la puntuación es <80.✓ Copiado
    → Archivo de flujo de trabajo agregado; corre en relaciones públicas
  2. Establecer rigor por ruta
    Las habilidades de producción fallan < 90; los borradores permiten < 70.✓ Copiado
    → Umbrales matriciales o condicionales en el flujo de trabajo

Resultado: Los RP que degradan la calidad de las habilidades quedan atrapados antes de fusionarse.

Errores comunes
  • Bloquear el listón demasiado alto y demasiado pronto — Comience de manera permisiva, ajuste durante 2 o 3 meses a medida que se solucionen los hallazgos
Combinar con: agent-skills-cli-skill

Diagnosticar por qué una habilidad no se activa

👤 Usuarios de Skill con problemas de activación. ⏱ ~15 min beginner

Cuándo usarlo: Instalaste una habilidad pero Claude nunca la activa.

Flujo
  1. Editar la descripción
    Vuelva a escribir la descripción para que aparezcan en ella las palabras clave concretas de la tarea del usuario.✓ Copiado
    → La gravedad de la claridad del gatillo disminuye

Resultado: Activación más clara; Claude elige la habilidad para las tareas adecuadas.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

skill-doctor-skill + oaustegard-claude-skills

Lint antes de publicar en el mercado

Ejecute Skill-Doctor localmente; luego abra un PR para oaustegard / claude-skills.✓ Copiado
skill-doctor-skill + agent-skills-cli-skill

Encadenar Skill-Doctor con otras herramientas de creación de habilidades

Utilice agent-skills-cli para realizar el andamiaje; Skill-Doctor para validar antes de comprometerse.✓ Copiado
skill-doctor-skill + claude-skill

Siga la guía de creación, luego pelusa

Escriba según la guía de habilidades de Claude; verificar con habilidad-doctor.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
skill-doctor <path> skill directory path Antes de publicar, en CI o para diagnosticar problemas de activación 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Ninguno: análisis estático local
Tokens por llamada
Ninguna (CLI, no una API)
Monetario
Gratis
Consejo
Ejecutar sólo en directorios que cambiaron; en CI, use filtros de ruta para evitar escanear todo el repositorio en cada PR.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales
Salida de datos: Ninguno: solo análisis local

Resolución de problemas

Errores comunes y soluciones

El doctor dice SKILL.md no encontrado

Ejecute desde la raíz de la habilidad (directorio que contiene SKILL.md), no desde la raíz del repositorio.

Verificar: ls SKILL.md in CWD
Fallos del esquema 'evals/evals.json'

Asegúrese de que cada evaluación tenga los campos obligatorios; un trozo mínimo es mejor que roto.

Verificar: jq . evals/evals.json
La puntuación no mejora después de las ediciones.

Repetición; Si un hallazgo persiste, lea la gravedad y los detalles; a veces las correcciones introducen nuevos problemas de baja gravedad.

Verificar: Diff the JSON reports between runs

Alternativas

skill-doctor vs otros

AlternativaCuándo usarlaContrapartida
agent-skills-cli-skillQuiere herramientas CLI generales para desarrollar/administrar habilidadesConjunto de características diferentes; no es una pelusa
claude-skillQuiere que la guía de creación entienda cómo es lo "bueno"Documentos, no una linter

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills