# hook-development

Скилл помогает создавать хуки для плагинов Claude Code: от перехвата опасных команд до проверки сборки перед завершением задачи.

- скилл · `type=skill` · Claude Code · 7028 установок · ★ 44635
- Автор: Anthropic · официальный репозиторий Anthropic
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/plugin-dev/skills/hook-development/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/hook-development

## Что делает

Скилл содержит спецификации и шаблоны для настройки хуков в Claude Code. Он объясняет, как перехватывать действия агента до вызова инструментов через `PreToolUse`, проверять результаты в `PostToolUse` и блокировать преждевременную остановку задачи событием `Stop`.

Внутри описаны два формата конфигурации: `hooks/hooks.json` с обёрткой `hooks` для плагинов и прямой список событий для `.claude/settings.json`. Скилл разбирает prompt-based хуки для проверки условий через LLM и command-хуки на bash, где код возврата 2 передаёт ошибку обратно модели, а переменные окружения сохраняются через `$CLAUDE_ENV_FILE`.

Ставить стоит тем, кто пишет собственные плагины или хочет внедрить жесткие политики безопасности для команд терминала. Если вы используете Claude Code только для базового чата без кастомных скриптов, скилл вам не понадобится.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin install plugin-dev@claude-plugins-official
```
Команда ставит плагин plugin-dev целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-plugins-official --skill hook-development -a claude-code
```

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

### Codex

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install anthropics/claude-plugins-official hook-development
```

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

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/anthropics/claude-plugins-official --path plugins/plugin-dev/skills/hook-development
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/plugin-dev/skills/hook-development/SKILL.md

## Когда брать
- заблокировать вызов опасных команд до их выполнения через `PreToolUse`
- настроить проверку прохождения тестов перед выходом агента по событию `Stop`
- загрузить переменные окружения в начале сессии через `SessionStart` и `$CLAUDE_ENV_FILE`
- проверить код инструмента на ошибки синтаксиса в `PostToolUse`

## Примеры запросов агенту
- Помоги написать PreToolUse хук на bash, который блокирует удаление файлов
- Как настроить prompt-based хук для проверки тестов перед завершением сессии?
- Создай hooks.json для плагина с обработкой событий SessionStart и Stop

## Похожие
- [docker-development](https://affpapa.org/nevibecode/skills/docker-development.md) — скилл · 702 установки
- [declarative-agents](https://affpapa.org/nevibecode/skills/declarative-agents.md) — скилл · 8700 установок
- [dependency-checker](https://affpapa.org/nevibecode/hooks/dependency-checker.md) — хук · 2314 установок
- [doubt-driven-development](https://affpapa.org/nevibecode/skills/doubt-driven-development.md) — скилл · 56700 установок
- [wizard](https://affpapa.org/nevibecode/skills/wizard.md) — скилл · 553369 установок
- [hyperframes-cli](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes-cli.md) — скилл · 1300000 установок
- [setup-pre-commit](https://affpapa.org/nevibecode/skills/setup-pre-commit.md) — скилл · 489289 установок
- [using-git-worktrees](https://affpapa.org/nevibecode/skills/using-git-worktrees.md) — скилл · 217153 установки

Из того же набора: [anthropics/claude-plugins-official](https://affpapa.org/nevibecode/by/anthropics/claude-plugins-official.md) — 123 карточки

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

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