Agent skill

Agnix

by agent-sh in agent-sh/agnix

A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.

Apache-2.0Auto-check passedAgent Workflows

Install Agnix

skills CLI
$ npx skills add agent-sh/agnix --skill agnix -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agent-sh/agnix agnix --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agent-sh/agnix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agnix .claude/skills/agnix && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agnix
GitHub stars
446
Token cost
~563 tokens
SKILL.md length
187 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.

  • Works in 3 steps: agnix --version. If it is missing,… → agnix . (or the path the user named). → If the user asked for fixes: agnix --fix…
  • User asks to lint agent configs
  • SKILL.md covers Run, CLI reference, Supported files and Output, plus 2 more sections
  • Calls npm and cargo

What it does

Agnix is an agent skill from agent-sh/agnix. Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 455 rules.

Its SKILL.md is about 560 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Linting and formatting, Agent instruction files and MCP servers. It works with Model Context Protocol, Visual Studio Code and Rust. The repository describes itself as: 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. The licence is Apache-2.0.

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. agnix --version. If it is missing, install with npm install -g agnix or cargo install agnix-cli.
  2. agnix . (or the path the user named).
  3. If the user asked for fixes: agnix --fix ., then run step 2 again to confirm what remains. Otherwise change no files; agnix --dry-run…

What it can do on your machine

Read from SKILL.md and the folder at commit 004b7ea. 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):

    • agent-sh.github.io

    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 563 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 187 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~563

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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 004b7ea, republished under its Apache-2.0 licence (© agent-sh). 187 words, ~563 tokens.

Download SKILL.mdSave it as .claude/skills/agnix/SKILL.md (or your agent's skills folder).
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 455 rules.
allowed-tools
Bash(agnix:*), Bash(cargo:*), Read, Glob, Grep

agnix

Lint agent configurations (Skills, Hooks, MCP, Memory, Plugins) before they break a workflow, across Claude Code, Codex CLI, OpenCode, Kiro, Cursor, GitHub Copilot and other tools.

Run

  1. agnix --version. If it is missing, install with npm install -g agnix or cargo install agnix-cli.
  2. agnix . (or the path the user named).
  3. If the user asked for fixes: agnix --fix ., then run step 2 again to confirm what remains. Otherwise change no files; agnix --dry-run . previews the fixes.

CLI reference

CommandDescription
agnix .Validate current project
agnix --fix .Apply safe auto-fixes
agnix --dry-run .Show what would be fixed, change nothing
agnix --strict .Treat warnings as errors
agnix --target claude-code .Target one tool: generic (default), claude-code, cursor, codex, kiro
agnix --watch .Watch mode
agnix --format json .JSON output

Supported files

File TypeExamples
SkillsSKILL.md
MemoryCLAUDE.md, AGENTS.md
Hooks.claude/settings.json
MCP*.mcp.json
Cursor.cursor/rules/*.mdc
Copilot.github/copilot-instructions.md

Output

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

© 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 skills/agnix of agent-sh/agnix.

Open the folder on GitHubat commit 004b7ea

Compare with similar skills

Agnix next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agnix compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agnix this skillagent-sh/agnix446—~563Automated safety check: PassApache-2.0
Zed Configwcygan/dotfiles196—~930Automated safety check: PassNone
Claude Docs Consultantcentminmod/my-claude-code-setup2.7k—~959Automated safety check: PassMIT
Typescript Styletjx666/vscode-mcp105—~961Automated safety check: PassCustom licence
Vscode MCP Architecturetjx666/vscode-mcp105—~1.5kAutomated safety check: PassCustom licence
Rsigmatimescale/rsigma162—~1.2kAutomated safety check: PassMIT

Similar skills

  • Zed Config

    wcygan/dotfiles

    Zed editor configuration expert. An agent skill from wcygan/dotfiles.

    196 GitHub stars~930 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Claude Docs Consultant

    centminmod/my-claude-code-setup

    Consult official Claude Code documentation from code.claude.com using selective fetching.

    2.7k GitHub stars~959 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Typescript Style

    tjx666/vscode-mcp

    TypeScript code style and repo conventions for VSCode MCP — inference vs explicit types, ESM import suffixes, zod schema contracts, async VSCode/Node APIs, JSON-safe IPC results, JSDoc for public…

    105 GitHub stars~961 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Vscode MCP Architecture

    tjx666/vscode-mcp

    VSCode MCP Bridge project architecture — current monorepo layout, IPC/EventDispatcher flow, per-workspace socket discovery, MCP/CLI adapters, tool filtering, and VSCode extension services.

    105 GitHub stars~1.5k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Rsigma

    timescale/rsigma

    Use the rsigma CLI and MCP server: engine eval, engine daemon, rule lint, rule draft, rule tune, rule backtest, backend convert, mcp serve.

    162 GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Audits a project's agent configuration, instruction drift, hooks, MCP and AI maintainability, then reports prioritized findings with evidence and next actions.

    7.2k GitHub stars~5.2k tokensUpdated today
    Agent WorkflowsAuto-check: notes

More from agent-sh/agnix

  • Agnix

    agent-sh/agnix

    A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.

    446 GitHub stars~874 tokensUpdated today
    Auto-check passed

Questions about Agnix

What does Agnix do?

A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Agnix is an agent skill from agent-sh/agnix.md', 'validate hooks', 'lint MCP'.

When should I use Agnix?

Agnix fits situations like: user asks to lint agent configs; validate skills; check CLAUDE.md.

How do I install Agnix in Claude Code?

Run `npx skills add agent-sh/agnix --skill agnix -a claude-code`. Or copy the skill folder (skills/agnix in agent-sh/agnix) into .claude/skills/agnix in your project. Claude Code loads it when a task matches its description.

How do I install Agnix in Codex?

Run `npx skills add agent-sh/agnix --skill agnix -a codex`. Or copy the skill folder (skills/agnix in agent-sh/agnix) into .agents/skills/agnix in your project. Codex loads it when a task matches its description.

Can I use Agnix in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agent-sh/agnix --skill agnix -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agnix, .gemini/skills/agnix, .github/skills/agnix and .opencode/skills/agnix in your project.

What does Agnix need to run?

Going by SKILL.md and its folder, Agnix needs the command-line tools its instructions call (npm and cargo). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash(agnix:*), Bash(cargo:*), Read, Glob, Grep.

Does Agnix access the network?

SKILL.md names 1 domain. As links in the text: agent-sh.github.io. This is read from the text; nothing was executed.

Is Agnix safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agnix use?

Agnix is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agnix use?

About 563 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agnix?

Skills that share tags, products or a category with Agnix: Zed Config (wcygan/dotfiles, 196 stars), Claude Docs Consultant (centminmod/my-claude-code-setup, 2.7k stars), Typescript Style (tjx666/vscode-mcp, 105 stars) and Vscode MCP Architecture (tjx666/vscode-mcp, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agnix?

agent-sh (a GitHub organization) maintains it in agent-sh/agnix, which has 446 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 9, 2026.

Source: agent-sh/agnix on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.