# agnix

Проверяет скиллы, хуки, MCP-серверы и файлы памяти до того, как они сломают рабочий процесс. Запускается одной командой в проекте.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 458
- Автор: agent-sh
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/agent-sh/agnix/tree/HEAD/plugin/skills/agnix/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/agent-sh-agnix

## Что делает

agnix проходит по конфигурационным файлам агента и сверяет их с набором правил: имя скилла, триггеры в описании, настройки хуков, определения инструментов MCP, структура `AGENTS.md`. Находит типичное — имя скилла заглавными буквами, каталог не совпадает с полем `name:`, в `CLAUDE.md` лежит что-то вроде «be helpful», чего модель и так знает. Категории правил разбиты по префиксам: AS-* для скиллов, CC-* для Claude, MCP-* для протокола, PE-* для промптов, XP-* для кросс-платформенной совместимости.

Запуск: `agnix .` в корне проекта, при необходимости с `--strict`, чтобы предупреждения считались ошибками. Флаг `--fix` применяет безопасные правки, а `agnix --dry-run .` сначала показывает, что будет изменено. Без `--fix` файлы не трогаются. Целевой инструмент задаётся через `--target claude-code`; без него CLI берёт `generic`. Есть режим наблюдения `--watch .` и вывод в JSON или SARIF — последний подходит для GitHub Code Scanning.

Сам CLI ставится отдельно от скилла: `npm install -g agnix` или `cargo install agnix-cli`, есть сборки для Homebrew и PyPI. Коды возврата простые: 0 — ошибок нет, 1 — есть, 2 — неверные аргументы. Для CI в репозитории лежит GitHub Action.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add agent-sh/agnix --skill agnix -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/agnix/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/agnix/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add agent-sh/agnix --skill agnix -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/agnix/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add agent-sh/agnix --skill agnix -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/agnix/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install agent-sh/agnix agnix
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/agnix/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add agent-sh/agnix --skill agnix -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/agent-sh/agnix --path plugin/skills/agnix
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/agnix/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add agent-sh/agnix --skill agnix -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/agent-sh/agnix/tree/HEAD/plugin/skills/agnix/SKILL.md

## Когда брать
- поймать битое имя скилла до запуска агента
- сверить каталог скилла с полем `name:`
- вычистить общие фразы из `CLAUDE.md`
- проверить настройки хуков и MCP-серверов
- прогнать конфиги в CI и не пропустить предупреждения

## Примеры запросов агенту
- Проверь конфиги агента в текущем проекте: `agnix .`
- Прогони строгую проверку с автоправками: `agnix --fix --strict .`
- Покажи, что будет исправлено, без изменений: `agnix --dry-run .`

## Похожие
- [project-bootstrap](https://affpapa.org/nevibecode/skills/project-bootstrap.md) — скилл · 794 установки
- [Quality Gates](https://affpapa.org/nevibecode/skills/quality-gates.md) — скилл · 536 установок
- [shellcheck-configuration](https://affpapa.org/nevibecode/skills/shellcheck-configuration.md) — скилл · 11533 установки
- [bash-script-validator](https://affpapa.org/nevibecode/skills/bash-script-validator.md) — скилл · 679 установок
- [Docker Configuration Validator](https://affpapa.org/nevibecode/skills/docker-configuration-validator.md) — скилл · 336 установок
- [go-ci](https://affpapa.org/nevibecode/skills/go-ci.md) — скилл · ★ 83

Из того же набора: [agent-sh/agnix](https://affpapa.org/nevibecode/by/agent-sh/agnix.md) — 2 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
