# setup-agent-guard

Скилл находит локальный бинарник Agent Guard, проверяет зависимости и тестирует хуки безопасности. Он выручит при сбоях защиты или предупреждениях SessionStart.

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

## Что делает

Скилл настраивает и чинит Agent Guard прямо внутри плагина. Сначала он ищет бинарник `../../bin/agent-guard` относительно своей директории, а не подменяет его глобальной версией из `PATH`. Диагностика запускается через команду `setup`. Если в системе нет `jq`, агент подберёт менеджер пакетов и запросит подтверждение. При нехватке `gitleaks` скачивание пойдёт только с официальной сверкой SHA-256. Без явного согласия пользователя установка системных пакетов и вызов `sudo` запрещены.

Второй шаг проверяет работу хуков хоста. Для Codex это статус перехватчиков `SessionStart`, `PreToolUse` и `PostToolUse` в настройках, где каждый хук обязан быть в статусе доверенного. Для Claude Code плагин перезагружается, а проверка идёт через инструмент `Bash`. Никаких правок `config.toml` в обход интерфейса хоста.

Финальную защиту подтверждают тестовые зонды, а не просто статус утилит. Скилл посылает тестовые маркеры в поток команд. Пре-хук обязан заблокировать запуск маркера, а пост-хук заменяет вывод на `[REDACTED]`. Реальные секретные файлы при такой проверке не читаются.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install JeongJaeSoon/agent-guard setup-agent-guard
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- проверить и настроить локальный бинарник Agent Guard
- установить недостающие зависимости jq и gitleaks по хешам
- протестировать перехват команд тестовыми зондами без чтения секретов
- исправить предупреждения SessionStart о снижении уровня защиты

## Примеры запросов агенту
- Проверь статус защиты Agent Guard и устрани предупреждение SessionStart
- Настрой зависимости gitleaks и проверь работу хуков в Claude Code
- Выполни диагностику плагина через /agent-guard:setup-agent-guard

## Похожие
- [git-guardrails-claude-code](https://affpapa.org/nevibecode/skills/git-guardrails-claude-code.md) — скилл · 499069 установок
- [ponytail-review](https://affpapa.org/nevibecode/skills/ponytail-review.md) — скилл · 57000 установок
- [ponytail-audit](https://affpapa.org/nevibecode/skills/ponytail-audit.md) — скилл · 45400 установок
- [security-audit](https://affpapa.org/nevibecode/skills/cloudflare-security-audit.md) — скилл · 54800 установок
- [security-and-hardening](https://affpapa.org/nevibecode/skills/security-and-hardening.md) — скилл · 70200 установок
- [supabase](https://affpapa.org/nevibecode/skills/supabase.md) — скилл · 8 установок

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

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

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