mcpField
A
agnix

agnix

github.com/agent-shTesting & quality462137 installsUpdated today
Repository

About agnix

agnix is a CLI linter for agent configuration files, for teams validating workflows across coding and agent tools. It checks skills, hooks, MCP, memory, and plugin configuration, and can preview or apply safe fixes.

Key features

  1. 01Lint agent configuration files
  2. 02Validate skills, hooks, MCP, and memory
  3. 03Target specific coding tools
  4. 04Apply or preview safe fixes
  5. 05Watch files and emit JSON

Use cases

  1. 01Check configuration before a workflow change
  2. 02Validate MCP configuration files
  3. 03Find skill naming and trigger issues
  4. 04Preview fixes in a project

MCP support

agnix validates MCP configuration files such as *.mcp.json as part of agent configuration linting. It does not describe an MCP server or client.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/agent-sh/agnix --skill agnix

After installing, type/agnixin Claude Code to confirm it loaded.

Details

From the project README

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

Links

Comments

Markdown supported