CommunityRedacción y edicióngithub.com

SimaAlexandru99/agentscan

Encuentra configuraciones rotas de agentes: hooks cuyos scripts han desaparecido, skills/MCP que discrepan con el disco. Sin red.

¿Qué es agentscan?

Agentscan es un linter de solo lectura para la configuración de agentes de IA, diseñado para detectar inconsistencias entre la configuración declarada y el estado real del disco. Escanea hooks, skills, MCP y archivos como `AGENTS.md`, `.claude/`, `.commandcode/`, `.agents/`, `.mcp.json` y `skills-lock.json`, reportando hallazgos como hechos. Se ejecuta localmente sin necesidad de red, lo que lo hace ideal para entornos aislados. Su salida en formato `prompt` está pensada para que un agente reparador resuelva los problemas automáticamente, destacando errores como `claude.hook.missing-script`.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add SimaAlexandru99/agentscan

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace agentscan?

Linter de solo lectura para la configuración del agente. Los hallazgos son hechos.

Cuándo usarlo

  • Cuando trabajes con hooks, skills, MCP o AGENTS.md
  • Cuando alguien dice que un guardia está activo y no has verificado el script
  • Cuando un PR toca .claude/, .commandcode/, .agents/, .mcp.json, o skills-lock.json

Qué hacer

Desde la raíz del repositorio:

npx @chimix/agentscan@latest --output prompt

--output prompt es el traspaso para el agente que corrige. No omitas claude.hook.missing-script (error).

Si no tienes un proyecto a mano:

npx @chimix/agentscan@latest demo

demo construye un fixture desechable, imprime el informe y elimina el fixture.

Qué no hacer

  • Escribir en el árbol escaneado
  • Adivinar con el modelo si un hook es válido
  • Comparar el name del frontmatter de una skill con su directorio, o validar ids de modelo

Skills relacionados