agnix · agent-sh — скилл для Claude Code: что делает и как установить
Проверяет файлы конфигурации агентов по базе из 702 правил и исправляет типичные ошибки разметки. Пригодится при настройке скиллов, хуков, MCP и инструкций вроде CLAUDE.md.
npx skills add agent-sh/agnix --skill agnix -a claude-codeЧто делает agnix
Скилл запускает утилиту agnix, которая находит нестыковки в файлах настроек проекта. Он сканирует инструкции CLAUDE.md, правила .cursor/rules/*.mdc, описания SKILL.md, хуки в .claude/settings.json и манифесты *.mcp.json. Инструмент распознаёт 702 правила. Он видит пустые советы вроде «будь точным», ошибки в названиях папок и пропущенные триггеры вызова.
Для работы в системе должна стоять CLI-утилита agnix через npm install -g agnix или cargo install agnix-cli. Без установленного бинарника проверки не запустятся. При вызове ассистент выполняет agnix . или указывает цель через --target claude-code.
Команда --fix вносит безопасные правки сразу в файлы, а --dry-run только показывает запланированные изменения. Флаг --strict превращает предупреждения в ошибки сборки.
Какие задачи решает
- найти ошибки в файлах SKILL.md и манифестах *.mcp.json
- убрать общие фразы из инструкций CLAUDE.md
- выровнять имена папок со значениями поля name
- проверить конфигурации агентов перед коммитом
Примеры запросов агенту
- Проверь конфиги агента через agnix
- Запусти валидацию скиллов и исправь найденные ошибки
- Сделай dry-run проверку CLAUDE.md
Как установить agnix
1Через Skills CLI (Vercel)
npx skills add agent-sh/agnix --skill agnix -a claude-code2Вручную: положить файлы
~/.claude/skills/agnix/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/agnix/
1Через Skills CLI (Vercel)
npx skills add agent-sh/agnix --skill agnix -a codex2Вручную: положить файлы
.agents/skills/agnix/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add agent-sh/agnix --skill agnix -a cursor2Вручную: положить файлы
.cursor/skills/agnix/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install agent-sh/agnix agnix2Вручную: положить файлы
.github/skills/agnix/SKILL.md1Через Skills CLI (Vercel)
npx skills add agent-sh/agnix --skill agnix -a gemini-cli2Командой платформы
gemini skills install https://github.com/agent-sh/agnix --path skills/agnixВручную: положить файлы
.devin/skills/agnix/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add agent-sh/agnix --skill agnix -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о agnix
Как установить agnix в Claude Code?
Выполните команду npx skills add agent-sh/agnix --skill agnix -a claude-code.
Что проверяет agnix?
Скилл валидирует файлы SKILL.md, CLAUDE.md, AGENTS.md, конфигурации хуков .claude/settings.json, схемы *.mcp.json и инструкции Cursor по 702 правилам.
Что нужно установить перед запуском скилла?
Требуется утилита командной строки agnix. Её ставят через npm install -g agnix либо с помощью cargo install agnix-cli.
Исходный текст
SKILL.md · Apache-2.0
--- 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 702 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 | Command | Description | |---------|-------------| | `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 Type | Examples | |-----------|----------| | Skills | `SKILL.md` | | Memory | `CLAUDE.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 | Issue | Solution | |-------|----------| | Invalid skill name | Use lowercase with hyphens: `my-skill` | | Generic instructions | Remove "be helpful", "be accurate" | | Missing trigger phrase | Add "Use when..." to description | | Directory/name mismatch | Rename directory to match `name:` field | ## Links - [GitHub](https://github.com/agent-sh/agnix) - [Rules Reference](https://agent-sh.github.io/agnix/docs/rules/)
© agent-sh · Apache-2.0 · agent-sh/agnix
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — agnix от других авторов.
