К основному содержанию
субагент CX Codex

agnix-agent — субагент для Claude Code: проверка конфигов агентов

Субагент, который запускает agnix CLI внутри проекта и возвращает результаты проверки конфигураций агентов в структурированном виде.

Apache-2.0 ★ 493 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/agnix-agent.md
Открыть на GitHub

Что делает 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 или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты 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

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
environment-setup akillness Скилл environment-setup разбирает конфигурацию приложения по полочкам: какие переменные держать в .env, что коммитить, как проверять обязательные значения и где граница с секретами. CX Codex +1 354установок validation josstei Скилл validation для Claude Code проводит проект через сборку, линтеры и тесты и разбирает результат. Проверяет этапы работы агента и отдельные изменения. CX Codex +1 ★ 489звёзд репо ce-setup EveryInc Скилл ce-setup для Claude Code проверяет инструменты и конфигурацию Compound Engineering в репозитории, создаёт пакеты и обновляет документацию по коду. Запускается при настройке окружения или в CI. CX Codex +1 3 600установок project-min-evaluation purrfold Скилл project-min-evaluation заставляет агента прогнать линтер, типы и тесты проекта, прежде чем объявить работу готовой. Полезен, когда не хочется ловить поломки после коммита. CX Codex +1 5 700установок om-create-skill open-mercato Скилл om-create-skill создаёт новый OM-скилл по брифу или разбивает разросшийся SKILL.md на слои references/. Работает в режиме авторинга или консервативного сплита, за линт-гейтом и проверкой полноты. CX Codex +1 4 000установок lint-on-save davila7 Хук lint-on-save запускает линтер сразу после того, как агент изменил файл. ESLint, Pylint и RuboCop срабатывают сами, без ручного вызова. 3 235установок

Из того же набора5

Спонсоры проекта

Компании, которые помогают держать аналитику открытой