agnix
- Repo stars 264
- Author repo agnix
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @agent-sh · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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
```bash
agnix --version
```
If not found, install:
```bash
cargo install agnix-cli
```
### 2. Validate
```bash
agnix .
```
### 3. If issues found and --fix requested
```bash
agnix --fix .
```
### 4. Re-validate to confirm
```bash
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://avifenesh.github.io/agnix/docs/rules)
Sections and files
Listed in source order.
sections -> When to Use → Supported Files → Execution → 1. Check if agnix is installed → 2. Validate → 3. If issues found and --fix requested
terms -> Lint agent configurations before they break your workflow. · | Command | Description | |---------|-------------| | agnix .
files/cmd -> CLAUDE.md · AGENTS.md · .claude/settings.json · *.mcp.json · .cursor/rules/*.mdc · .github/copilot-instructions.md · agnix . · agnix --fix .
body sha256 -> 58447c42a84c
When to Use
Invoke when user asks to: "Lint my agent configs" "Validate my skills" "Check my CLAUDE.md" "Validate hooks"
Supported Files
File Type · Examples Skills ·
SKILL.mdMemory ·CLAUDE.md,AGENTS.mdHooks ·.claude/settings.jsonMCP ·*.mcp.json1. Check if agnix is installed
If not found, install:
CLI Reference
Command · Description
agnix .· Validate current projectagnix --fix .· Auto-fix issuesagnix --strict .· Treat warnings as errorsagnix --target claude-code .· Only Claude Code rulesCommon Issues & Fixes
Issue · Solution Invalid skill name · Use lowercase with hyphens:
my-skillGeneric instructions · Remove "be helpful", "be accurate" Missing trigger phrase · Add "Use when..." to description Directory/name mismatch · Rename directory to matchname:field