Claude
Skills
← Back

agnix

Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 230 rules.

AI Agents

What this skill does


# 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/avifenesh/agnix)
- [Rules Reference](https://avifenesh.github.io/agnix/docs/rules)
Files: 1
Size: 2.8 KB
Complexity: 11/100
Category: AI Agents

Related in AI Agents