How do I install the Agnix skill?

Run npx skillmds@latest add agent-sh/agnix in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agnix safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agnix?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agnix free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

agent-sh (@agent-sh) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agnix by agent-sh — Agent Skill

Name: Agnix
Author: agent-sh

File contents

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

---name: agnixdescription: Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 455 rules.---# agnixLint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins across Claude Code, Cursor, GitHub Copilot, and Codex CLI.## When to UseInvoke 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```bashagnix --version```If not found, install:```bashcargo install agnix-cli```### 2. Validate```bashagnix .```### 3. If issues found and --fix requested```bashagnix --fix .```### 4. Re-validate to confirm```bashagnix .```## 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 onlyFound 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://agent-sh.github.io/agnix/docs/rules/)

Frequently asked questions

Agnix