agnix
Lint agent configurations (Skills, Hooks, MCP, Memory, Plugins) before they break a workflow, across Claude Code, Codex CLI, OpenCode, Kiro, Cursor, GitHub Copilot and other tools.
Run
agnix --version. If it is missing, install with npm install -g agnix or cargo install agnix-cli.
agnix . (or the path the user named).
- If the user asked for fixes:
agnix --fix ., then run step 2 again to confirm what remains. Otherwise change no files; agnix --dry-run . previews the fixes.
CLI reference
| Command | Description |
|---|
agnix . | Validate current project |
agnix --fix . | Apply safe auto-fixes |
agnix --dry-run . | Show what would be fixed, change nothing |
agnix --strict . | Treat warnings as errors |
agnix --target claude-code . | Target one tool: generic (default), claude-code, cursor, codex, kiro |
agnix --watch . | Watch mode |
agnix --format json . | JSON output |
Supported files
| File Type | Examples |
|---|
| Skills | SKILL.md |
| Memory | CLAUDE.md, AGENTS.md |
| Hooks | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
Output
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)
Common fixes
| Issue | Solution |
|---|
| Invalid skill name | Use lowercase with hyphens: my-skill |
| Generic instructions | Remove "be helpful", "be accurate" |
| Missing trigger phrase | Add "Use when..." to description |
| Directory/name mismatch | Rename directory to match name: field |
Links