/agnix
Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 447 rules.
$ npx -y skills add agent-sh/agnix --skill agnix --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/agnix
Context preview
The summary Claude sees to decide when to auto-load this skill.
Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 447 rules.
SKILL.md
agnix.SKILL.mdname: agnix
description: "Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 447 rules."
allowed-tools: Bash(agnix:*), Bash(cargo:*), Read, Glob, Grep
agnix
Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins across Claude Code, Cursor, GitHub Copilot, and Codex CLI.
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"
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` |
Execution
1. Check if agnix is installed
agnix --version
If not found, install:
cargo install agnix-cli
2. Validate
agnix .
3. If issues found and --fix requested
agnix --fix .
4. Re-validate to confirm
agnix .
CLI Reference
| Command | Description | |---------|-------------| | `agnix .` | Validate current project | | `agnix --fix .` | Auto-fix issues | | `agnix --strict .` | Treat warnings as errors | | `agnix --target claude-code .` | Only Claude Code rules | | `agnix --target cursor .` | Only Cursor rules | | `agnix --watch .` | Watch mode | | `agnix --format json .` | JSON output |
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)
Common Issues & 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
- [GitHub](https://github.com/agent-sh/agnix)
- [Rules Reference](https://agent-sh.github.io/agnix/docs/rules/)
Read more
name: agnix description: "Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 447 rules." allowed-tools: Bash(agnix:*), Bash(cargo:*), Read, Glob, Grep
agnix
Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins across Claude Code, Cursor, GitHub Copilot, and Codex CLI.
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"
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` |
Execution
1. Check if agnix is installed
agnix --version
If not found, install:
cargo install agnix-cli
2. Validate
agnix .
3. If issues found and --fix requested
agnix --fix .
4. Re-validate to confirm
agnix .
CLI Reference
| Command | Description | |---------|-------------| | `agnix .` | Validate current project | | `agnix --fix .` | Auto-fix issues | | `agnix --strict .` | Treat warnings as errors | | `agnix --target claude-code .` | Only Claude Code rules | | `agnix --target cursor .` | Only Cursor rules | | `agnix --watch .` | Watch mode | | `agnix --format json .` | JSON output |
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)
Common Issues & 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
- [GitHub](https://github.com/agent-sh/agnix)
- [Rules Reference](https://agent-sh.github.io/agnix/docs/rules/)
The missing linter and lsp for AI coding assistants. Validate CLAUDE.md, AGENTS.md, SKILL.md, hooks, MCP. Plugin for all major IDEs included, with autofixes.