# webhook-development

Скилл для проектирования вебхуков: доставка событий, проверка подписи, ретраи и обработка недоставленных сообщений.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 504 установки · ★ 371
- Автор: aj-geddes
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/aj-geddes/useful-ai-prompts/tree/HEAD/skills/webhook-development/SKILL.md
- Обновлён: 2026-03-04
- HTML: https://affpapa.org/nevibecode/skills/webhook-development

## Что делает

Скилл помогает агенту собрать систему вебхуков: отправка событий во внешние сервисы, проверка подписи, повторные попытки при сбое и dead-letter для тех сообщений, что так и не дошли. Пригодится, когда нужно уведомлять сторонние платформы о заказах или платежах и вести журнал событий.

Внутри — быстрый стартовый пример с JSON-схемой события (`id`, `timestamp`, `event`, `version`, `data`, `attempt`, `retryable`) и справочники в каталоге `references/`: схема события, сервис на Node.js, обработчик на Python и практики. Агент читает эти файлы, когда пишет код.

Скилл не привязан к конкретному фреймворку, поэтому решения по хранилищу и очереди придётся принимать самому. Проверка подписи и ретраи описаны как подход, а не как готовая библиотека — это повод сверить реализацию с требованиями вашего провайдера до выката.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill webhook-development -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill webhook-development -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill webhook-development -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aj-geddes/useful-ai-prompts webhook-development
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill webhook-development -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aj-geddes/useful-ai-prompts --path skills/webhook-development
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill webhook-development -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aj-geddes/useful-ai-prompts/tree/HEAD/skills/webhook-development/SKILL.md

## Когда брать
- отправлять уведомления о заказах во внешние сервисы
- проверять подпись входящего вебхука
- повторять доставку события после сбоя
- складывать недоставленные события в dead-letter
- вести журнал событий для аудита

## Примеры запросов агенту
- Спроектируй вебхук для события order.created с проверкой подписи и ретраями
- Добавь dead-letter очередь для вебхуков, которые не доставились после нескольких попыток
- Покажи схему события вебхука для оплаты заказа

## Похожие
- [webhook-platform-design](https://affpapa.org/nevibecode/skills/webhook-platform-design.md) — скилл · 8100 установок
- [iii-error-handling](https://affpapa.org/nevibecode/skills/iii-error-handling.md) — скилл · 4100 установок
- [catalyst-signals](https://affpapa.org/nevibecode/skills/catalyst-signals.md) — скилл · 938 установок
- [inngest](https://affpapa.org/nevibecode/skills/sickn33-inngest.md) — скилл · 1200 установок
- [planetscale-webhook-automation-recommendations](https://affpapa.org/nevibecode/skills/planetscale-webhook-automation-recommendations.md) — скилл · 1700 установок
- [sent-webhook-engineer](https://affpapa.org/nevibecode/skills/sent-webhook-engineer.md) — скилл · 2700 установок

Из того же набора: [aj-geddes/useful-ai-prompts](https://affpapa.org/nevibecode/by/aj-geddes/useful-ai-prompts.md) — 143 карточки

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

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