agnix
Linte as configurações do agente antes que elas quebrem seu fluxo de trabalho. Valida Skills, Hooks, MCP, Memória, Plugins no Claude Code, Cursor, GitHub Copilot e Codex CLI.
Quando Usar
Invocar quando o usuário pedir:
- "Lint meus configs de agente"
- "Validar minhas skills"
- "Verificar meu CLAUDE.md"
- "Validar hooks"
- "Lint configs MCP"
- "Corrigir problemas de configuração do agente"
Arquivos Suportados
| Tipo de Arquivo | Exemplos |
|---|---|
| Skills | SKILL.md |
| Memória | CLAUDE.md, AGENTS.md |
| Hooks | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
Execução
1. Verificar se o agnix está instalado
agnix --version
Se não encontrado, instale:
cargo install agnix-cli
2. Validar
agnix .
3. Se problemas forem encontrados e --fix for solicitado
agnix --fix .
4. Revalidar para confirmar
agnix .
Referência da CLI
| Comando | Descrição |
|---|---|
agnix . | Validar projeto atual |
agnix --fix . | Corrigir automaticamente problemas |
agnix --strict . | Tratar avisos como erros |
agnix --target claude-code . | Apenas regras do Claude Code |
agnix --target cursor . | Apenas regras do Cursor |
agnix --watch . | Modo de observação |
agnix --format json . | Saída em JSON |
Formato de Saída
CLAUDE.md:15:1 warning: Instrução genérica 'Seja útil' [corrigível]
ajuda: Remova instruções genéricas. Claude já sabe disso.
skills/review/SKILL.md:3:1 error: Nome inválido [corrigível]
ajuda: Use apenas letras minúsculas e hífens
Encontrado 1 erro, 1 aviso (2 corrigíveis)
Problemas Comuns e Correções
| Problema | Solução |
|---|---|
| Nome de skill inválido | Use letras minúsculas com hífens: minha-skill |
| Instruções genéricas | Remova "seja útil", "seja preciso" |
| Frase de gatilho ausente | Adicione "Use quando..." na descrição |
| Incompatibilidade diretório/nome | Renomeie o diretório para corresponder ao campo name: |