Skill de Diagnóstico de Complementos de Agente
Este skill proporciona capacidades de diagnóstico y validación para complementos (plugins) de agente.
Requisitos de ejecución
La instalación de este skill no instala la CLI Doctor. Doctor es un
paquete npm independiente (@agent-plugins-doctor/cli, expuesto como el
binario agent-plugins-doctor) que este skill invoca a través del terminal:
- Bun —
bunx agent-plugins-doctor check <directorio-del-plugin> - npm —
npx agent-plugins-doctor check <directorio-del-plugin>
bunx/npx obtienen la CLI del registro npm en el primer uso y la ejecutan
sin necesidad de clonar el repositorio, compilar el workspace ni instalar de forma global. Se requiere que al menos Bun o npm estén instalados, disponibles en el PATH y con acceso al registro npm. Si ninguno está disponible, los comandos siguientes fallarán con un error "comando no encontrado".
Cuándo usar
Utiliza este skill cuando los usuarios pregunten:
- "¿Por qué no funciona mi complemento de agente?"
- "Revisa este complemento de agente"
- "Corrige este complemento"
- "¿Este complemento es compatible con Cursor/Codex/VS Code?"
- "Audita este complemento de agente"
- "Valida este complemento"
Uso
Ejecuta la CLI Doctor para validar complementos:
# Revisar un complemento
bunx agent-plugins-doctor check <directorio-del-plugin>
# Aplicar correcciones seguras
bunx agent-plugins-doctor fix <directorio-del-plugin>
# Generar un informe
bunx agent-plugins-doctor report <directorio-del-plugin> --format markdown
# Revisar compatibilidad
bunx agent-plugins-doctor compatibility <directorio-del-plugin>
(npx agent-plugins-doctor ... funciona de forma idéntica con npm).
Qué valida
Doctor valida:
- El manifiesto del complemento (plugin.json) según el esquema oficial
- Las definiciones de habilidades (archivos SKILL.md) para verificar su corrección
- Las configuraciones del servidor MCP (mcp.json) para validar su validez
- Problemas de seguridad (secretos, path traversal, escapes de enlaces simbólicos)
- Compatibilidad con clientes verificados (VS Code, Cursor, GitHub Copilot, ChatGPT y Codex, Kiro)
Resultados
Doctor proporciona:
- Mensajes de error claros con códigos de diagnóstico
- Ubicaciones de archivos
- Explicaciones de qué está mal y por qué
- Correcciones automáticas seguras cuando es posible
- Informes de compatibilidad para todos los clientes verificados
Ejemplos
# Validar el directorio actual
bunx agent-plugins-doctor check .
# Corregir problemas en un complemento
bunx agent-plugins-doctor fix ./mi-plugin
# Generar un informe en markdown
bunx agent-plugins-doctor report ./mi-plugin --format markdown > report.md
# Revisar compatibilidad con un cliente específico
bunx agent-plugins-doctor compatibility ./mi-plugin --client cursor