Agnix

agnix

Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins across 10+ AI tools including Claude Code, Cursor, GitHub Copilot, Codex CLI, OpenCode, Gemini CLI, Cline, Windsurf, Kiro, and Amp.

Parse Arguments

const args = '$ARGUMENTS'.split(' ').filter(Boolean);
const targetPath = args.find(a => !a.startsWith('--')) || '.';
const fix = args.includes('--fix');
const strict = args.includes('--strict');
let target = args.find(a => a.startsWith('--target='))?.split('=')[1];
if (!target) {
  const idx = args.indexOf('--target');
  if (idx !== -1 && args[idx + 1]) target = args[idx + 1];
}
target = target || 'claude-code';

When to Use

Invoke when user asks to:

• "Lint my agent configs"
• "Validate my skills"
• "Check my CLAUDE.md"
• "Validate hooks"
• "Lint MCP configs"
• "Fix agent configuration issues"
• "Check if my SKILL.md is correct"

Prerequisites

agnix must be installed. Check with:

agnix --version

If not installed:

cargo install agnix-cli

Execution

1. Validate Project

agnix .

2. If Issues Found and Fix Requested

agnix --fix .

3. Re-validate to Confirm

agnix .

CLI Reference

Supported Files

Output Format

CLAUDE.md:15:1 warning: Generic instruction 'Be helpful' [fixable]
  help: Remove generic instructions. Claude already knows this.

skills/review/SKILL.md:3:1 error: Invalid name [fixable]
  help: Use lowercase letters and hyphens only

Found 1 error, 1 warning (2 fixable)

Exit codes:

• 0 - No errors (warnings allowed)
• 1 - Errors found
• 2 - Invalid arguments

Rule Categories

Common Issues & Fixes

Integration

This skill is standalone and can be invoked directly via /agnix.

For CI integration, see the GitHub Action.

Links

• GitHub
• Rules Reference
• Configuration