Agnix

What it does

When your agent uses it

• User asks to lint agent configs
• Validate skills
• Check CLAUDE.md

Example prompts

• “lint agent configs”
• “validate skills”
• “check CLAUDE.md”
• “/agnix”

Requirements

• Node.js
• Pre-approved tools (allowed-tools): Bash(agnix:*), Bash(cargo:*), Read, Glob, Grep

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1agnix --version. If it is missing, install with npm install -g agnix or cargo install agnix-cli (also on Homebrew and PyPI).
2. 2agnix [--strict] [--target ] .
3. 3With --fix: agnix --fix [--target ] , then run step 2 again to confirm what remains. Without --fix, change no files; agnix --dry-run…

What it can do on your machine

Read from SKILL.md and the folder at commit fa3ba36. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(agnix:*)
  • Bash(cargo:*)
  • Read
  • Glob
  • Grep

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npm
  • cargo

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • github.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agnix loads about 874 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 296 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~48

When it runs · the whole SKILL.md, loaded when a task matches

~874

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from agent-sh/agnix at commit fa3ba36, republished under its Apache-2.0 licence (© agent-sh). 296 words, ~874 tokens.

name

agnix

description

Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 457 rules across 10+ AI tools.

allowed-tools

Bash(agnix:*), Bash(cargo:*), Read, Glob, Grep

argument-hint

[path] [--fix] [--strict] [--target=generic|claude-code|cursor|codex|kiro]

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)

© agent-sh, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugin/skills/agnix of agent-sh/agnix.

Open the folder on GitHubat commit fa3ba36