agnix
Linter les configurations d'agent avant qu'elles ne perturbent votre workflow. Valide les Compétences, Hooks, MCP, Mémoire, Plugins pour Claude Code, Cursor, GitHub Copilot et Codex CLI.
Quand l'utiliser
Invoquer lorsque l'utilisateur demande :
- « Linter mes configurations d'agent »
- « Valider mes compétences »
- « Vérifier mon CLAUDE.md »
- « Valider les hooks »
- « Linter les configurations MCP »
- « Corriger les problèmes de configuration d'agent »
Fichiers pris en charge
| Type de fichier | Exemples |
|---|---|
| Compétences | SKILL.md |
| Mémoire | CLAUDE.md, AGENTS.md |
| Hooks | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
Exécution
1. Vérifier si agnix est installé
agnix --version
S'il n'est pas trouvé, installer :
cargo install agnix-cli
2. Valider
agnix .
3. Si des problèmes sont trouvés et que --fix est demandé
agnix --fix .
4. Re-valider pour confirmer
agnix .
Référence CLI
| Commande | Description |
|---|---|
agnix . | Valider le projet actuel |
agnix --fix . | Corriger automatiquement les problèmes |
agnix --strict . | Traiter les avertissements comme des erreurs |
agnix --target claude-code . | Règles Claude Code uniquement |
agnix --target cursor . | Règles Cursor uniquement |
agnix --watch . | Mode surveillance |
agnix --format json . | Sortie JSON |
Format de sortie
CLAUDE.md:15:1 avertissement : Instruction générique « Soyez utile » [corrigible]
aide : Supprimez les instructions génériques. Claude le sait déjà.
skills/review/SKILL.md:3:1 erreur : Nom invalide [corrigible]
aide : Utilisez uniquement des lettres minuscules et des traits d'union.
1 erreur, 1 avertissement trouvés (2 corrigibles)
Problèmes courants et corrections
| Problème | Solution |
|---|---|
| Nom de compétence invalide | Utilisez des minuscules avec traits d'union : my-skill |
| Instructions génériques | Supprimez « soyez utile », « soyez précis » |
| Phrase de déclenchement manquante | Ajoutez « Utiliser lorsque... » dans la description |
| Incohérence répertoire/nom | Renommez le répertoire pour correspondre au champ name: |