agnix
- Repo stars 264
- Author repo agnix
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
- Fluxly category
- 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
- Author / version / license
- @agent-sh · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Guided setup
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Shell exec
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. Invoke when user asks to: "Lint my agent configs" "Validate my skills"
File Type · Examples Skills · SKILL.md Memory · CLAUDE.md, AGENTS.md
Execution
If not found, install:
2. Validate
3. If issues found and --fix requested
# 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` |
… Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
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
Decide Fit First
Design Intent
How To Use It
Boundaries And Review