About Agnix
Agnix is an MCP server in the Blockchain category: 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.
Install
git clone https://github.com/agent-sh/agnixThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (9)
[AGENTS.md](https://agentsmd.org)AGM-\*, XP-\*
Parameters not published.
[Agent Skills](https://agentskills.io)AS-\*, CC-SK-\*
Parameters not published.
[Claude Code](https://docs.anthropic.com/en/docs/build-with-claude/claude-code)CC-\*
Parameters not published.
[Cline](https://docs.cline.bot)CLN-\*
Parameters not published.
[Cursor](https://cursor.com)CUR-\*
Parameters not published.
[Gemini CLI](https://github.com/google-gemini/gemini-cli)GM-\*
Parameters not published.
[GitHub Copilot](https://docs.github.com/en/copilot)COP-\*
Parameters not published.
[Kiro](https://kiro.dev)KIRO-\*, KR-SK-\*, KR-AG-\*, KR-HK-\*, KR-PW-\*, KR-MCP-\*
Parameters not published.
[MCP](https://modelcontextprotocol.io)MCP-\*
Parameters not published.
Ask AI
Ask AI about Agnix
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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 - 418 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 |
GitHub Action
- name: Validate agent configs
uses: agent-sh/agnix@v0
with:
target: 'claude-code'
Usage
agnix . # Validate current directory
agnix --fix . # Apply HIGH and MEDIUM confidence fixes
agnix --fix-safe . # Apply only HIGH confidence fixes
agnix --fix-unsafe . # Apply all fixes, including LOW confidence
agnix --dry-run --show-fixes . # Preview fixes with inline diff output
agnix --strict . # Strict mode (warnings = errors)
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-* | 51 | .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 fromknowledge-base/rules.jsonagnix-core- shared validation engine libraryagnix-cli- command-line interface binaryagnix-lsp- language server binaryagnix-mcp- MCP server binaryagnix-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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.