agnix — команда для Claude Code: линт конфигов агента и автофиксы
Команда agnix для Claude Code проверяет скиллы, хуки, MCP-серверы и файлы памяти агента по 757 правилам и автоматически исправляет часть замечаний. Находит ошибки в растущих конфигах агента.
Apache-2.0 ★ 493 обновлён 2026-11-11
.claude/commands/agnix.mdЧто делает agnix
Команда /agnix проверяет конфиги агента: скиллы, хуки, MCP-серверы, файлы памяти и плагины. База — 757 правил для Claude, Codex CLI, Cursor, GitHub Copilot, Claude и других инструментов. На выходе таблица с файлом, строкой, уровнем, кодом правила и сообщением, плюс сводка: сколько ошибок, сколько предупреждений и сколько из них чинится автоматически.
Работу делает субагент agnix:agnix-agent, которого команда запускает через Task. Если Task недоступен, шаги из skills/agnix/SKILL.md выполняются прямо в текущей сессии. Результат приходит JSON между маркерами === AGNIX_RESULT === и === END_RESULT ===. Когда блок не разобрался, вы увидите сырой вывод агента, а не бодрый отчёт «проблем нет».
Аргументы: путь (по умолчанию .), --fix для автоисправлений, --strict переводит предупреждения в ошибки, --target принимает generic, claude-code, cursor, codex или kiro. Незнакомое значение --target молча уходит в generic, так что опечатка в имени платформы даст проверку по общим правилам.
Какие задачи решает
- поймать битое имя скилла до того, как агент его загрузит
- перепроверить хуки и MCP-конфиги после правок руками
- переименовать и поправить то, что чинится без человека
- прогнать
CLAUDE.mdна общие формулировки-заглушки - сверить конфиг с правилами одной платформы через
--target
Примеры запросов агенту
- Проверь конфиги агента в этом репозитории:
/agnix - Запусти
/agnix .claude --strictи покажи, что осталось после автофиксов - Почини, что можно:
/agnix --fix --target cursor
Как установить agnix
Вручную: положить файлы
.claude/commands/agnix.mdВызов — /agnix. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/agnix.mdВызов — /prompts:agnix. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/agnix.prompt.mdВручную: положить файлы
.gemini/commands/agnix.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы об agnix
Как установить agnix в Claude Code?
Положить файл команды в .claude/commands/agnix.md внутри проекта — после этого /agnix появится в Claude.
Что делает agnix?
Линтует скиллы, хуки, MCP-серверы, файлы памяти и плагины по 757 правилам, показывает замечания по файлам и строкам и умеет применять автоисправления.
Что нужно, чтобы agnix заработал?
CLI agnix в системе: npm install -g agnix или cargo install agnix-cli. Без него команда покажет подсказку по установке вместо отчёта.
Исходный текст
agnix.md · Apache-2.0
---
description: Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP', or mentions 'agent config issues', 'skill validation'.
codex-description: 'Use when user asks to "lint agent configs", "validate skills", "check CLAUDE.md", "validate hooks", "lint MCP". Validates agent configuration files against 760 rules across 10+ AI tools.'
argument-hint: "[path] [--fix] [--strict] [--target [target]]"
allowed-tools: Task, Read, Bash(agnix:*)
---
# /agnix - Agent Config Linter
Lint agent configurations (Skills, Hooks, MCP, Memory, Plugins) for Claude Code, Codex CLI, Cursor, GitHub Copilot, Kiro and other tools, and show the findings.
## Arguments
From `$ARGUMENTS`:
- **path**: the first argument that is not a flag or the value of `--target`. Default `.`. Remove newlines from it before passing it on.
- **--fix**: apply auto-fixes.
- **--strict**: treat warnings as errors.
- **--target**: `generic` (default), `claude-code`, `cursor`, `codex` or `kiro`, as `--target=X` or `--target X`. Any other value falls back to `generic`.
## Run
Spawn `agnix:agnix-agent` with:
```
Validate agent configurations.
Path: {path}
Fix: {true|false}
Strict: {true|false}
Target: {target}
Return structured results between === AGNIX_RESULT === markers.
```
Without the Task tool, run the steps of the plugin's `skills/agnix/SKILL.md` in this session.
Parse the JSON between `=== AGNIX_RESULT ===` and `=== END_RESULT ===` as JSON. If the block is missing or does not parse, show the agent's raw output instead of reporting zero issues.
## Report
No issues:
```markdown
## Validation Passed
No issues found in agent configurations.
- Files validated: N
- Target: {target}
```
Issues found:
```markdown
## Agent Config Issues
| File | Line | Level | Rule | Message |
|------|------|-------|------|---------|
| SKILL.md | 3 | error | AS-004 | Invalid name |
| CLAUDE.md | 15 | warning | PE-003 | Generic instruction |
## Summary
- **Errors**: N
- **Warnings**: N
- **Fixable**: N
## Do Next
- [ ] Run `/agnix --fix` to auto-fix {fixable} issues
- [ ] Review remaining issues manually
```
After `--fix`:
```markdown
## Fixed Issues
| File | Line | Rule | Fix Applied |
|------|------|------|-------------|
| SKILL.md | 3 | AS-004 | Renamed to lowercase |
**Fixed**: N issues
**Remaining**: N issues (manual review needed)
```
## Errors
- agnix not installed: show the install command, `npm install -g agnix` or `cargo install agnix-cli`.
- Path not found: `Path not found: [path]`.
- agnix output that cannot be parsed: show the raw output.
## Links
- [agnix GitHub](https://github.com/agent-sh/agnix)
- [Rules Reference](https://github.com/agent-sh/agnix/blob/main/knowledge-base/VALIDATION-RULES.md)
© agent-sh · Apache-2.0 · agent-sh/agnix