CommunityEscrita e Ediçãogithub.com

SimaAlexandru99/agentscan

Encontre configurações de agente quebradas: hooks cujos scripts desapareceram, MCP/skills que discordam do disco. Sem rede.

O que é agentscan?

O agentscan é um linter somente leitura para configurações de agentes de IA, como Claude Code, Cursor ou Codex. Ele verifica se as configurações de hooks, skills, MCP (Model Context Protocol) ou arquivos como `AGENTS.md` estão consistentes com o disco, sem fazer nenhuma requisição de rede. Por exemplo, ele detecta hooks cujo script referenciado não existe mais, ou skills declaradas que não correspondem aos diretórios no sistema de arquivos. A ferramenta é útil para desenvolvedores que querem garantir que seus ambientes de agentes estão íntegros antes de executar tarefas automatizadas. Seu uso principal é executar `npx @chimix/agentscan@latest --output prompt` para gerar um relatório que serve como handoff para o agente corrigir os problemas encontrados. Também é possível usar o modo `demo` para testar rapidamente sem um projeto real.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add SimaAlexandru99/agentscan

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que agentscan faz?

Linter somente leitura para configurações de agente. Descobertas são fatos.

Quando

  • Hook, skill, MCP ou AGENTS.md funcionam
  • Alguém diz que uma guarda está ativa e você não verificou o script
  • Um PR modifica .claude/, .commandcode/, .agents/, .mcp.json ou skills-lock.json

Faça

A partir da raiz do repositório:

npx @chimix/agentscan@latest --output prompt

--output prompt é o handoff para o agente que corrige. Não pule claude.hook.missing-script (erro).

Sem um projeto à mão:

npx @chimix/agentscan@latest demo

demo constrói um fixture descartável, imprime o relatório e exclui o fixture.

Não faça

  • Escrever a árvore escaneada
  • Adivinhar com o modelo se um hook é válido
  • Comparar o name do frontmatter de uma skill com seu diretório, ou validar ids de modelo

Habilidades Relacionadas