Skill Doctor de Plugins de Agente
Esta skill fornece capacidades de diagnóstico e validação para Plugins de Agente.
Requisitos de Execução
Instalar esta skill não instala o CLI Doctor. Doctor é um
pacote npm separado (@agent-plugins-doctor/cli, exposto como o
binário agent-plugins-doctor) que esta skill invoca através do terminal:
- Bun —
bunx agent-plugins-doctor check <diretório-do-plugin> - npm —
npx agent-plugins-doctor check <diretório-do-plugin>
bunx/npx buscam o CLI do registro npm no primeiro uso e o executam —
nenhum checkout de código, build do workspace ou instalação global é necessária. Pelo menos
um dos dois, Bun ou npm, deve estar instalado, disponível no PATH e capaz
de acessar o registro npm. Se nenhum estiver disponível, os comandos abaixo falham
com um erro "comando não encontrado".
Quando Usar
Use esta skill quando usuários perguntarem:
- "Por que meu Plugin de Agente não funciona?"
- "Verifique este Plugin de Agente"
- "Corrija este plugin"
- "Este plugin é compatível com Cursor/Codex/VS Code?"
- "Audite este Plugin de Agente"
- "Valide este plugin"
Uso
Execute o CLI Doctor para validar plugins:
# Verificar um plugin
bunx agent-plugins-doctor check <diretório-do-plugin>
# Aplicar correções seguras
bunx agent-plugins-doctor fix <diretório-do-plugin>
# Gerar um relatório
bunx agent-plugins-doctor report <diretório-do-plugin> --format markdown
# Verificar compatibilidade
bunx agent-plugins-doctor compatibility <diretório-do-plugin>
(npx agent-plugins-doctor ... funciona de forma idêntica com npm.)
O Que Ele Verifica
O Doctor valida:
- Manifesto do plugin (plugin.json) contra o esquema oficial
- Definições de Skill (arquivos SKILL.md) quanto à correção
- Configurações do servidor MCP (mcp.json) quanto à validade
- Problemas de segurança (segredos, path traversal, symlink escapes)
- Compatibilidade com clientes verificados (VS Code, Cursor, GitHub Copilot, ChatGPT & Codex, Kiro)
Saída
O Doctor fornece:
- Mensagens de erro claras com códigos de diagnóstico
- Localizações de arquivos
- Explicações do que está errado e por quê
- Correções automáticas seguras quando possível
- Relatórios de compatibilidade para todos os clientes verificados
Exemplos
# Validar o diretório atual
bunx agent-plugins-doctor check .
# Corrigir problemas em um plugin
bunx agent-plugins-doctor fix ./meu-plugin
# Gerar um relatório markdown
bunx agent-plugins-doctor report ./meu-plugin --format markdown > relatorio.md
# Verificar compatibilidade com um cliente específico
bunx agent-plugins-doctor compatibility ./meu-plugin --client cursor