agnix-agent — субагент для Claude Code: проверка конфигов агентов
Субагент, который запускает agnix CLI внутри проекта и возвращает результаты проверки конфигураций агентов в структурированном виде.
Apache-2.0 ★ 493 обновлён 2026-10-24
.claude/agents/agnix-agent.mdЧто делает agnix-agent
Запускает утилиту agnix для линтинга конфигов агентов (.md, .toml), собирает ошибки, предупреждения и исправимые диагностики. Умеет автоматически чинить найденные проблемы флагом --fix и повторно проверять результат. Возвращает данные как JSON-блок AGNIX_RESULT с числом файлов, уровнями диагностик и списком нарушений.
Поддерживает таргеты generic, claude-code, cursor, codex и kiro, режим --strict для строгой проверки. Если agnix не установлен, вернёт ошибку с командой установки (npm install -g agnix или cargo install agnix-cli).
Вызывается через команду /agnix — не загружайте его вручную как скилл, чтобы не создать циклическую зависимость.
Какие задачи решает
- проверить конфиги агентов на ошибки перед коммитом
- автоматически исправить нарушения стандартов в
.mdи.toml - получить структурированный отчёт по диагностикам с указанием файла и строки
- прогнать линтер в строгом режиме для конкретной платформы
Примеры запросов агенту
- Проверь все конфиги агентов в проекте через
/agnix - Запусти
/agnixс автоматическим исправлением - Прогони agnix в строгом режиме для Claude Code
Как установить agnix-agent
Вручную: положить файлы
.claude/agents/agnix-agent.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/agnix-agent.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/agnix-agent.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об agnix-agent
Как установить agnix-agent в Claude Code?
Положите файл конфигурации в .claude/agents/agnix-agent.md в корне проекта. Для Cursor — в .cursor/agents/agnix-agent.md, для Codex — в .codex/agents/agnix-agent.toml.
Что делает agnix-agent?
Запускает CLI-утилиту agnix внутри проекта, собирает диагностики конфигов агентов (ошибки, предупреждения, исправимые нарушения) и возвращает результат в виде JSON-блока для команды /agnix.
Что нужно для работы agnix-agent?
Установленная утилита agnix — через npm install -g agnix или cargo install agnix-cli. Если её нет, субагент вернёт ошибку с инструкцией по установке.
Исходный текст
agnix-agent.md · Apache-2.0
---
name: agnix-agent
description: Lint agent configurations with the agnix CLI and return the validation results as an AGNIX_RESULT block. Used by /agnix.
tools:
- Bash(agnix:*)
- Bash(cargo:*)
- Read
- Glob
- Grep
model: sonnet
---
# Agnix Agent
Run the agnix CLI on the path the caller gives and return the results as structured data for `/agnix`.
The prompt carries `Path` (default `.`), `Fix`, `Strict` and `Target` (`generic`, `claude-code`, `cursor`, `codex` or `kiro`). Run the CLI yourself as described in the plugin's `skills/agnix/SKILL.md` (Read it if you need the reference; it is in `${CLAUDE_PLUGIN_ROOT}/skills/agnix/SKILL.md`, or Glob for `**/agnix/*/skills/agnix/SKILL.md`). Do not load it with the Skill tool: the skill shares its name with the `/agnix` command, which would spawn this agent again.
1. `agnix --version`. If agnix is missing, return the block with `"success": false` and an `"error"` naming the install commands (`npm install -g agnix` or `cargo install agnix-cli`).
2. `agnix [--strict] [--target <target>] <path>`. Leave `--target` off for `generic`. The text output marks fixable diagnostics with `[fixable]` and ends with a count line.
3. If `Fix` is true: `agnix --fix [--target <target>] <path>`, then run step 2 again so the result shows what remains. Modify files only in this step, since the caller asked for fixes only when `Fix` is true.
End your reply with:
```
=== AGNIX_RESULT ===
{
"path": ".",
"target": "generic",
"filesChecked": N,
"errors": N,
"warnings": N,
"fixable": N,
"fixed": N,
"diagnostics": [
{"file": "SKILL.md", "line": 3, "level": "error", "rule": "AS-004", "message": "Invalid name", "fixable": true}
],
"success": true
}
=== END_RESULT ===
```
`success` is false when agnix could not run; findings in the configs are not a failure. `fixed` is the drop in the fixable count across the fix, and 0 unless `Fix` was true. `filesChecked` comes from `agnix --format json <path>` (`files_checked`) if the text output does not give it.
© agent-sh · Apache-2.0 · agent-sh/agnix