agnix
Lint configuraciones de agentes antes de que rompan tu flujo de trabajo. Valida Skills, Hooks, MCP, Memoria, Plugins en Claude Code, Cursor, GitHub Copilot y Codex CLI.
Cuándo Usarlo
Invoca cuando el usuario pida:
- "Lint mis configuraciones de agente"
- "Validar mis skills"
- "Revisar mi CLAUDE.md"
- "Validar hooks"
- "Lint configs MCP"
- "Arreglar problemas de configuración de agentes"
Archivos Soportados
| Tipo de Archivo | Ejemplos |
|---|---|
| Skills | SKILL.md |
| Memoria | CLAUDE.md, AGENTS.md |
| Hooks | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
Ejecución
1. Verificar si agnix está instalado
agnix --version
Si no se encuentra, instalar:
cargo install agnix-cli
2. Validar
agnix .
3. Si se encuentran problemas y se solicitó --fix
agnix --fix .
4. Revalidar para confirmar
agnix .
Referencia CLI
| Comando | Descripción |
|---|---|
agnix . | Validar el proyecto actual |
agnix --fix . | Auto-corregir problemas |
agnix --strict . | Tratar advertencias como errores |
agnix --target claude-code . | Solo reglas de Claude Code |
agnix --target cursor . | Solo reglas de Cursor |
agnix --watch . | Modo vigilancia |
agnix --format json . | Salida en JSON |
Formato de Salida
CLAUDE.md:15:1 warning: Instrucción genérica 'Sé útil' [corregible]
ayuda: Elimina instrucciones genéricas. Claude ya sabe esto.
skills/review/SKILL.md:3:1 error: Nombre inválido [corregible]
ayuda: Usa solo minúsculas y guiones.
Encontrado 1 error, 1 advertencia (2 corregibles)
Problemas Comunes y Soluciones
| Problema | Solución |
|---|---|
| Nombre de skill inválido | Usa minúsculas con guiones: mi-skill |
| Instrucciones genéricas | Elimina "sé útil", "sé preciso" |
| Falta frase de activación | Agrega "Usar cuando..." a la descripción |
| Desajuste de directorio/nombre | Renombra el directorio para que coincida con el campo name: |