Back to Skills

agnix

avifenesh
Updated 2 days ago
6 views
258
24
258
View on GitHub
Metaaimcp

About

Agnix validates AI agent configuration files against 421 rules across 10+ tools like Claude Code and Cursor. Use it to lint agent configs, validate skills, check CLAUDE.md, validate hooks, or lint MCP configurations. It supports optional auto-fixing, strict mode, and specific tool targeting.

Quick Install

Claude Code

Recommended
Primary
npx skills add avifenesh/agnix -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/avifenesh/agnix
Git CloneAlternative
git clone https://github.com/avifenesh/agnix.git ~/.claude/skills/agnix

Copy and paste this command in Claude Code to install this skill

Documentation

agnix

Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins across 10+ AI tools including Claude Code, Cursor, GitHub Copilot, Codex CLI, OpenCode, Gemini CLI, Cline, Windsurf, Kiro, and Amp.

Parse Arguments

const args = '$ARGUMENTS'.split(' ').filter(Boolean);
const targetPath = args.find(a => !a.startsWith('--')) || '.';
const fix = args.includes('--fix');
const strict = args.includes('--strict');
let target = args.find(a => a.startsWith('--target='))?.split('=')[1];
if (!target) {
  const idx = args.indexOf('--target');
  if (idx !== -1 && args[idx + 1]) target = args[idx + 1];
}
target = target || 'claude-code';

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"
  • "Check if my SKILL.md is correct"

Prerequisites

agnix must be installed. Check with:

agnix --version

If not installed:

cargo install agnix-cli

Execution

1. Validate Project

agnix .

2. If Issues Found and Fix Requested

agnix --fix .

3. 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 - re-validate on changes
agnix --format json .JSON output
agnix --format sarif .SARIF for GitHub Code Scanning

Supported Files

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

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)

Exit codes:

  • 0 - No errors (warnings allowed)
  • 1 - Errors found
  • 2 - Invalid arguments

Rule Categories

PrefixCategoryExamples
AS-*Agent SkillsName format, triggers, description
CC-*Claude CodeHooks, memory, plugins
MCP-*MCP ProtocolServer config, tool definitions
PE-*Prompt EngineeringGeneric instructions, redundancy
XP-*Cross-PlatformCompatibility across tools
AGM-*AGENTS.mdStructure, sections
COP-*GitHub CopilotInstructions format
CUR-*CursorMDC format, rules

Common Issues & Fixes

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

Integration

This skill is standalone and can be invoked directly via /agnix.

For CI integration, see the GitHub Action.

Links

GitHub Repository

avifenesh/agnix
Path: plugin/skills/agnix
0
agentaiai-agentsai-coding-assistantclaudecli

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill