Skillshub 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.

install
source · Clone the upstream repo
git clone https://github.com/ComeOnOliver/skillshub
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/agent-sh/agnix/agnix" ~/.claude/skills/comeonoliver-skillshub-agnix && rm -rf "$T"
manifest: skills/agent-sh/agnix/agnix/SKILL.md
source content

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 TypeExamples
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

CommandDescription
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

IssueSolution
Invalid skill nameUse lowercase with hyphens:
my-skill
Generic instructionsRemove "be helpful", "be accurate"
Missing trigger phraseAdd "Use when..." to description
Directory/name mismatchRename directory to match
name:
field

Links