skill-doctor MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Valida el frontmatter de SKILL.md y los metadatos de YAML
Detecta enlaces rotos y recursos de paquetes faltantes
Las puntuaciones activan la descripción y la claridad de las instrucciones
Valida el esquema evals/evals.json
Puntuación de 0 a 100 con hallazgos prácticos
Formatos de salida: texto, JSON, solo partitura
Patrón de flujo de trabajo de acciones de GitHub incorporado

Demo en vivo

Cómo se ve en la práctica

skill-doctor-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "skill-doctor-skill",
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "skill-doctor-skill": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "skill-doctor@latest",
          "."
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add skill-doctor-skill -- npx -y skill-doctor@latest .

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

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

ejecuta el doctor

Ejecute Skill-Doctor en la raíz de la habilidad.✓ Copiado

→ Puntuación + lista de hallazgos por gravedad
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

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
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

Ejecute el médico en el directorio de habilidades.

Ejecute Skill-Doctor en ~/.claude/skills/<skill>.✓ Copiado

→ Los hallazgos señalan problemas de activación débil o cuestiones preliminares
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

Herramienta	Entradas	Cuándo llamar	Coste
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

el médico experto informa problemas estructurales; no juzga la seguridad. Una puntuación alta ≠ una habilidad segura; aún revisa lo que la habilidad le pide a Claude que haga.

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

Alternativa	Cuándo usarla	Contrapartida
agent-skills-cli-skill	Quiere herramientas CLI generales para desarrollar/administrar habilidades	Conjunto de características diferentes; no es una pelusa
claude-skill	Quiere 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