Why agnix?

Your skills don't trigger. Vercel's research found skills invoke at 0% without correct syntax. One wrong field and your skill is invisible.

"Almost right" is the worst outcome. 66% of developers cite it as their biggest AI frustration. Misconfigured agents produce exactly this.

Multi-tool stacks fail silently. Cursor + Claude Code + Copilot each want different formats. A config that works in one tool breaks in another.

Bad patterns get amplified. AI assistants don't ignore wrong configs - they learn from them.

agnix validates all of it - 437 rules sourced from official specs, academic research, and real-world breakage patterns. Auto-fix included.

Want to try it first? Open the playground - paste any agent config, see diagnostics instantly. No install, runs in your browser.

Quick Start

$ npx agnix .
Validating: .

CLAUDE.md:15:1 warning: Generic instruction 'Be helpful and accurate' [fixable]
  help: Remove generic instructions. Claude already knows this.

.claude/skills/review/SKILL.md:3:1 error: Invalid name 'Review-Code' [fixable]
  help: Use lowercase letters and hyphens only (e.g., 'code-review')

Found 1 error, 1 warning
  2 issues are automatically fixable

hint: Run with --fix, --fix-safe, or --fix-unsafe to apply fixes

https://github.com/user-attachments/assets/72d5fe7c-476f-46ea-be64-5785cf6d5600

Install

# npm (recommended, all platforms)
npm install -g agnix

# Homebrew (macOS/Linux)
brew tap agent-sh/agnix && brew install agnix

# Cargo
cargo install agnix-cli

Pre-built binaries | All install options

Editor Extensions

Editor	Install
VS Code	VS Code Marketplace
JetBrains	JetBrains Marketplace
Neovim	`{ "agent-sh/agnix", config = function() require("agnix").setup() end }`
Zed	Search "agnix" in Extensions

Editor setup guide

GitHub Action

- name: Validate agent configs
  uses: agent-sh/agnix@v0
  with:
    target: 'claude-code'

Usage

agnix .              # Validate current directory
agnix --fix .        # Apply only safe fixes
agnix --fix-safe .   # Explicit safe-only fix mode
agnix --fix-unsafe . # Apply all fixes, including medium and LOW confidence
agnix --dry-run --show-fixes .  # Preview fixes with inline diff output
agnix --strict .     # Strict mode (warnings = errors)
agnix --format github .  # GitHub Actions annotations
agnix explain MCP-018    # Explain a rule and its evidence
agnix --target claude-code .  # Legacy target preset (primarily affects CC-* rules)
agnix --target kiro .         # Legacy target preset (use tools = [...] for tool-only filtering)

Full CLI reference | Full rules reference

Supported Tools

Tool	Rules	Count	Config Files
Agent Skills	AS-, CC-SK-	31	SKILL.md
Claude Code	CC-*	53	CLAUDE.md, hooks, agents, plugins
GitHub Copilot	COP-*	6	.github/copilot-instructions.md, .github/instructions/*.instructions.md
Cursor	CUR-*	16	.cursor/rules/.mdc, .cursorrules, .cursor/hooks.json, .cursor/agents//.md, .cursor/environment.json
Kiro	KIRO-, KR-SK-, KR-AG-, KR-HK-, KR-PW-, KR-MCP-	52	.kiro/steering/*/.md, .kiro/skills/*/SKILL.md, .kiro/agents/.json, .kiro/hooks/.kiro.hook, .kiro/settings/mcp.json, .kiro/powers//POWER.md
MCP	MCP-*	12	*.mcp.json
AGENTS.md	AGM-, XP-	13	AGENTS.md, AGENTS.local.md, AGENTS.override.md
Cline	CLN-*	4	.clinerules, .clinerules/.md, .clinerules/.txt
Gemini CLI	GM-*	9	GEMINI.md, GEMINI.local.md, .gemini/settings.json (hooks), gemini-extension.json (extensions), .geminiignore

Architecture

Rust workspace crates:

agnix-rules - rule metadata generated from knowledge-base/rules.json
agnix-core - shared validation engine library
agnix-cli - command-line interface binary
agnix-lsp - language server binary
agnix-mcp - MCP server binary
agnix-wasm - WebAssembly bindings for browser/runtime integrations

Contributing

Contributions welcome. See CONTRIBUTING.md for the development guide.

Report a bug | Request a rule | Good first issues

License

MIT OR Apache-2.0

Agnix

README