CommunityRédaction et éditiongithub.com

SimaAlexandru99/agentscan

Analyseur statique pour la configuration d'un agent IA permettant de détecter des hooks cassés, des MCP/skills en désaccord avec le disque. Aucune connexion réseau nécessaire.

Qu'est-ce que agentscan ?

Agentscan est un linter en lecture seule conçu pour inspecter et valider la configuration des agents IA (Claude Code, Cursor, Codex, etc.). Il vérifie que les scripts référencés dans les hooks existent bien sur le disque, que les fichiers MCP et skills correspondent à ce qui est déclaré, et que `AGENTS.md` est cohérent. Contrairement à une approche basée sur des modèles de langage, il ne devine rien : il compare simplement le contenu du disque avec les déclarations, sans besoin de réseau. Son utilité est particulièrement grande dans les pipelines CI/CD ou avant une revue de code, car il évite les erreurs silencieuses (hooks manquants, chemins invalides) et garantit que l'agent part d'une configuration saine. Il peut être exécuté avec `npx @chimix/agentscan@latest --output prompt` pour produire un rapport directement exploitable par l'agent correcteur, ou en mode démo pour tester sans projet réel.

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

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait agentscan ?

Analyseur statique en lecture seule pour la configuration d'un agent. Les résultats sont des faits.

Quand

  • Un hook, une skill, un MCP ou AGENTS.md fonctionne
  • Quelqu'un indique qu'une garde est active sans que vous ayez vérifié le script
  • Une PR modifie .claude/, .commandcode/, .agents/, .mcp.json ou skills-lock.json

Faire

Depuis la racine du dépôt :

npx @chimix/agentscan@latest --output prompt

--output prompt est le format de transmission pour l'agent qui corrige. Ne pas ignorer claude.hook.missing-script (erreur).

Pas de projet sous la main :

npx @chimix/agentscan@latest demo

demo construit un jeu de test temporaire, affiche le rapport, puis supprime le jeu de test.

Ne pas faire

  • Écrire l'arborescence analysée
  • Deviner avec le modèle si un hook est valide
  • Comparer le name du frontmatter d'une skill avec son dossier, ou valider les identifiants de modèle

Skills associés