agnix CLI
agnix — линтер для CLAUDE.md, AGENTS.md, SKILL.md, хуков и MCP-конфигов: 702 правила, автофикс и редакторские расширения для VS Code и JetBrains
- 457 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Автофиксы уровня --fix-unsafe переписывают конфиги агента на диске без отдельного подтверждения каждой правки
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agnixОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Автофиксы уровня --fix-unsafe переписывают конфиги агента на диске без отдельного подтверждения каждой правки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
agnix проверяет файлы конфигурации агентов: CLAUDE.md, AGENTS.md, SKILL.md, настройки хуков и MCP-серверов для Claude Code, Codex CLI, OpenCode, Cursor, Copilot и других. Запуск npx agnix . проходит по проекту и печатает находки в формате `path:line:col` с уровнем `error` или `warning`, причиной и пометкой `fixable` там, где есть автоисправление; флаги --fix, --fix-safe и --fix-unsafe применяют правки разного уровня опасности. Инструмент ставится через npm, Homebrew, pip с оберткой uvx agnix . без установки или Cargo для варианта на Rust, на котором написано ядро. Проект приводит пример находки: имя скилла `Review-Code` помечается ошибкой, потому что формат требует строчные буквы и дефисы, с готовым исправлением `code-review`. Отдельно есть пакет для GitHub Action, который проваливает CI при найденных ошибках, и редакторские расширения для VS Code, JetBrains, Neovim и Zed с подсветкой находок прямо в файле. Базу правил, 702 штуки на момент README, автор собирает из официальных спецификаций агентов, академических исследований и реальных случаев, когда конфиг тихо не срабатывал: в блоге разработчика приводится исследование Vercel о том, что скилл с неверным синтаксисом может вообще не вызываться моделью. В браузерной площадке agent-sh.github.io/agnix/playground можно вставить конфиг и увидеть диагностику без установки.
Для кого. Для разработчиков, которые ведут CLAUDE.md, AGENTS.md и несколько SKILL.md в одном репозитории и хотят ловить опечатки формата до того, как агент тихо проигнорирует файл.
Подходит, если
- В проекте несколько SKILL.md, и нужно проверить, что имя и описание соответствуют формату, который агент действительно подхватит
- CLAUDE.md разросся общими фразами вроде «будь полезным и точным», и нужно найти такие строки автоматически для удаления
- Проект одновременно поддерживает Claude Code, Cursor и Copilot, и конфиги для них должны проходить один общий набор правил в CI
- Нужно подсветить находки agnix прямо в редакторе: для этого есть расширения VS Code, JetBrains, Neovim и Zed
- Нужно оценить находки agnix до установки: браузерная страница agent-sh.github.io/agnix/playground принимает конфиг прямо в текстовом поле
Не подходит, если
- Нужна проверка смысла инструкций, а не формата файла: agnix ловит ошибки синтаксиса и структуры, но не оценивает, разумное ли вы написали правило
- Единственный агент в проекте нестандартный и не входит в список поддержанных форматов: правило под него просто не сработает
- Нет Node.js, Python, Homebrew или Cargo на машине и установка через один из них невозможна: других способов поставить бинарник README не описывает
Пример запроса к агенту
Проверь все CLAUDE.md, AGENTS.md и SKILL.md в этом репозитории через agnix и примени безопасные автоисправленияОграничения
Правила покрывают форматы, которые проект уже описал: CLAUDE.md, AGENTS.md, SKILL.md, хуки и MCP-конфиги для Claude Code, Codex CLI, OpenCode, Cursor, Copilot и остальных из списка README, а не произвольный агентный файл. Автофикс разделен на уровни --fix-safe и --fix-unsafe, то есть часть исправлений разработчик сам считает опасными и не включает их по умолчанию. GitHub Action и редакторские расширения для JetBrains и VS Code распространяются отдельно от основного пакета, их нужно подключать своей установкой.
Как отключить. Удалите зависимость agnix из проекта: `npm uninstall -g agnix`, `brew uninstall agnix` или `pip uninstall agnix` в зависимости от способа установки. Шаг GitHub Action убирается из файла сценария CI, а расширение редактора отключается или удаляется через его собственный менеджер расширений.
Частые вопросы
Как запустить agnix для Claude Code без установки?
Выполните npx agnix . в корне проекта. Команда проверит CLAUDE.md, AGENTS.md, SKILL.md и остальные поддержанные конфиги и покажет находки с уровнем `error` или `warning`.
Как применить автоисправления?
Флаг `--fix` или `--fix-safe` применяет безопасные правки, `--fix-unsafe` добавляет более опасные варианты, которые разработчик не включает по умолчанию.
Почему мой SKILL.md не срабатывает у агента, хотя файл существует?
Частая причина — неверный формат имени или описания. agnix приводит пример, где имя `Review-Code` помечается ошибкой, потому что формат требует строчные буквы и дефисы, и предлагает исправление `code-review`.
Можно ли проверять конфиги в CI?
Да, у проекта есть отдельный пакет GitHub Action, который проваливает сборку при найденных ошибках в CLAUDE.md, AGENTS.md, SKILL.md и других конфигах агентов.
Можно ли попробовать agnix без установки вообще?
Да, на странице agent-sh.github.io/agnix/playground можно вставить конфиг прямо в браузере и увидеть диагностику без npx и без локальной установки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛичный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации
agr — менеджер пакетов для скиллов агентов: ставит их из любого Git-репозитория в Claude Code, Cursor и Codex по манифесту с версиями, как npm или uv
Плагин со скиллами для Claude Code и Codex: исследование кода, тесты, рефакторинг и независимая проверка готовых изменений
CLI, который создает и поддерживает файлы контекста для кодовых агентов: CLAUDE.md, правила Cursor, AGENTS.md и инструкции Copilot, и держит их в актуальном вид
Rust SDK для агентов программирования и готовый CLI abstract: REPL, 34 инструмента, MCP, граф памяти, Anthropic и OpenAI, вывод JSON для CI
CodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
Коротко о README
README открывается статистикой про 66 процентов разработчиков, которые называют «почти правильный» результат ИИ главной проблемой, и ссылкой на исследование Vercel о скиллах, которые модель вообще не вызывает из-за неверного синтаксиса. Дальше идет пример находки для CLAUDE.md и SKILL.md, таблица способов установки через npm, Homebrew, pip и Cargo, список редакторских расширений и готовый шаг для GitHub Action.