К основному содержанию
скилл CX Codex

emitting-api-events — скилл для Claude Code: вебхуки

Скилл emitting-api-events для проектирования событийно-ориентированных API. Добавляет вебхуки, Server-Sent Events и интеграцию с брокерами сообщений в существующий бэкенд.

MIT 1 установок ★ 2 935 обновлён 2026-11-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill emitting-api-events -a claude-code
Открыть на GitHub

Что делает emitting-api-events

Скилл разбирает, какие мутации API должны порождать события, и строит вокруг них инфраструктуру. Имена событий следуют конвенции resource.action — например, order.created или user.updated. Для каждого типа задаётся версионированная схема с полями eventId, eventType, version, timestamp, source и data.

Публикация событий идёт через transactional outbox: запись в таблицу outbox происходит в той же транзакции, что и мутация, а отдельный процесс вычитывает её и публикует в брокер. Так события не теряются при падении приложения. Поддерживаются Redis Pub/Sub, RabbitMQ, Kafka и AWS SNS/SQS.

Для вебхуков скилл генерирует API подписки (POST /webhooks, GET /webhooks, DELETE /webhooks/:id) с валидацией URL и фильтрацией по типам событий. Доставка подписывается HMAC-SHA256, ретраи идут по экспоненциальной схеме: 1 мин, 5 мин, 30 мин, 2 ч, 24 ч. После 5 неудач подряд подписка деактивируется. SSE-эндпоинт GET /events/stream поддерживает Last-Event-ID для переподключения и доигрывания пропущенных событий. Без брокера сообщений и персистентного хранилища для outbox-таблицы этот скилл не запустить — это жёсткое требование из README.

Какие задачи решает

  • спроектировать событийную архитектуру вокруг мутаций API
  • настроить доставку вебхуков с подписью HMAC-SHA256 и ретраями
  • добавить Server-Sent Events с переподключением и повтором пропущенного
  • организовать transactional outbox, чтобы события не терялись при сбоях
  • создать dead-letter queue для событий, исчерпавших все попытки доставки

Примеры запросов агенту

  • Добавь вебхуки в мой API: endpoint POST /orders должен эмитить order.created
  • Настрой SSE-стрим GET /events/stream с поддержкой Last-Event-ID
  • Реализуй transactional outbox для Kafka, публикуй события каждые 100 мс

Как установить emitting-api-events

1Через Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill emitting-api-events -a claude-code

2Вручную: положить файлы

~/.claude/skills/emitting-api-events/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/emitting-api-events/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об emitting-api-events

Как установить emitting-api-events в Claude Code?

Выполните npx skills add jeremylongshore/tons-of-skills-marketplace --skill emitting-api-events -a claude-code. Файл скилла появится в ~/.claude/skills/emitting-api-events/SKILL.md.

Что делает emitting-api-events?

Строит событийно-ориентированную архитектуру для API: эмиссию событий из мутаций, реестр версионированных схем, управление подписками на вебхуки, доставку с ретраями, SSE-стриминг и dead-letter queue.

Какие зависимости нужны для работы?

Брокер сообщений — Redis Pub/Sub, RabbitMQ, Kafka или AWS SNS/SQS. Плюс персистентное хранилище для лога событий и подписок: PostgreSQL или MongoDB. Для очереди ретраев подойдёт Bull, Celery или управляемый сервис.

Исходный текст

SKILL.md · MIT
---
name: emitting-api-events
description: 'Build event-driven APIs with webhooks, Server-Sent Events, and real-time
  notifications.

  Use when building event-driven API architectures.

  Trigger with phrases like "add webhooks", "implement events", or "create event-driven
  API".

  '
allowed-tools: Read, Write, Edit, Grep, Glob, Bash(api:events-*)
version: 1.25.0
author: Jeremy Longshore <[email protected]>
license: MIT
tags:
- api
- webhooks
- emitting-api
compatibility: Designed for Claude Code
---
# Emitting API Events

## Overview

Build event-driven API architectures using outbound webhooks, Server-Sent Events (SSE), and message broker integration. Implement event emission from API mutations, event schema registry, subscriber management, delivery guarantees with retry logic, and event sourcing patterns for maintaining a complete audit log of API state changes.

## Prerequisites

- Message broker: Redis Pub/Sub, RabbitMQ, Apache Kafka, or AWS SNS/SQS
- Persistent storage for event log and subscriber registrations (PostgreSQL, MongoDB)
- Webhook delivery infrastructure with retry queue (Bull, Celery, or managed service)
- Event schema registry for versioned event type definitions
- SSE-capable web framework for real-time event streaming to browser clients

## Instructions

1. Identify event-producing operations using Grep and Read, cataloging every API mutation (POST, PUT, PATCH, DELETE) that should emit events, with event type names following `resource.action` convention (e.g., `order.created`, `user.updated`).
2. Define event schemas for each event type with versioning: include `eventId` (UUID), `eventType`, `version`, `timestamp` (ISO 8601), `source` (service identifier), and `data` (type-specific payload).
3. Implement the event emitter service that publishes events to the message broker after successful API mutations, using the transactional outbox pattern to ensure events are not lost on application crash.
4. Build a webhook subscription management API: `POST /webhooks` (subscribe), `GET /webhooks` (list), `DELETE /webhooks/:id` (unsubscribe), with URL validation, event type filtering, and signing secret generation.
5. Implement webhook delivery with HMAC-SHA256 signed payloads, configurable retry policy (exponential backoff: 1min, 5min, 30min, 2hr, 24hr), and automatic subscription deactivation after consecutive failures.
6. Add Server-Sent Events endpoint (`GET /events/stream`) for real-time event delivery to browser clients, with `Last-Event-ID` support for reconnection and missed event replay.
7. Create a dead-letter queue for events that exhaust all delivery retry attempts, with alerting and manual replay capability.
8. Write integration tests covering event emission, webhook delivery with signature verification, SSE stream connection with reconnection, and dead-letter queue behavior.

See [`references/implementation.md`](references/implementation.md) for the full implementation guide.

## Output

- `${CLAUDE_SKILL_DIR}/src/events/emitter.js` - Event emission service with outbox pattern
- `${CLAUDE_SKILL_DIR}/src/events/schemas/` - Versioned event type schema definitions
- `${CLAUDE_SKILL_DIR}/src/events/webhooks/` - Webhook delivery, signing, and retry logic
- `${CLAUDE_SKILL_DIR}/src/events/sse.js` - Server-Sent Events streaming endpoint
- `${CLAUDE_SKILL_DIR}/src/routes/webhooks.js` - Webhook subscription management API
- `${CLAUDE_SKILL_DIR}/src/events/dead-letter.js` - Dead-letter queue handler with replay
- `${CLAUDE_SKILL_DIR}/tests/events/` - Event emission and delivery integration tests

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Event lost on crash | Application crashes between database commit and event publish | Use transactional outbox pattern: write event to outbox table in same transaction, poll and publish separately |
| Webhook delivery failure | Subscriber endpoint unreachable or returns non-2xx | Retry with exponential backoff; deactivate subscription after 5 consecutive failures; notify subscriber admin |
| Event ordering violation | Concurrent mutations publish events out of order | Use partition keys (resource ID) for ordered delivery within a partition; accept out-of-order across partitions |
| SSE connection memory leak | Server accumulates stale SSE connections without cleanup | Implement heartbeat comments (`:keepalive\n\n`) every 15 seconds; detect and close dead connections |
| Schema version mismatch | Consumer expects v1 event format but receives v2 | Include `version` field in event envelope; support simultaneous v1/v2 delivery; deprecate old versions with notice |

Refer to [`references/errors.md`](references/errors.md) for comprehensive error patterns.

## Examples

**Order lifecycle events**: Emit `order.created`, `order.payment_received`, `order.shipped`, and `order.delivered` events with order details, enabling downstream services (warehouse, email, analytics) to react asynchronously.

**SSE live notifications**: Browser client connects to `GET /events/stream?types=message.received,order.updated` and receives real-time event updates with automatic reconnection and `Last-Event-ID` replay on network interruption.

**Transactional outbox**: Write the event record to an `outbox` table within the same database transaction as the API mutation, then poll the outbox table every 100ms to publish events to Kafka, ensuring at-least-once delivery.

See [`references/examples.md`](references/examples.md) for additional examples.

## Resources

- CloudEvents specification: https://cloudevents.io/
- Server-Sent Events (MDN): https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events
- Transactional outbox pattern: Microservices.io
- Webhook best practices: Standard Webhooks specification

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
api-integration-surface-strategy Samuel Berthe Скилл api-integration-surface-strategy помогает решить, какие поверхности интеграции платформа отдаёт наружу — REST, GraphQL, gRPC, вебхуки, SDK, MCP — и в каком порядке их строить. CX Codex +1 10 400установок api-integration-builder daffy0208 Скилл api-integration-builder для Claude Code ведёт агента при сборке интеграции со сторонним API. Описывает OAuth, повторы, лимиты частоты и вебхуки, включая ответы 429 и 401. CX Codex +1 244установок api-rate-limiting secondsky Скилл api-rate-limiting для Claude Code помогает добавить ограничения запросов к API. Он включается при защите публичных API, настройке тарифных лимитов или борьбе с перегрузкой запросами. CX Codex +1 515установок streaming assistant-ui Скилл streaming по проводным протоколам и бэкенд-хелперам assistant-ui: помогает собрать свой стриминговый эндпоинт и разобрать формат чанков. CX Codex +1 6 700установок API Rate Limiting taste f Промпт API Rate Limiting taste для ChatGPT, настраивающий правила ограничения частоты запросов к API. Помогает проектировать защиту бэкенда от злоупотреблений и сбоев. GP ChatGPT ★ 178 201звёзд репо api-test-mode-design Samuel Berthe Скилл api-test-mode-design для Claude Code проектирует тестовый режим публичного API. Он включается при запросах о песочнице, тестовых ключах, демо-данных или имитации событий вебхука. CX Codex +1 10 400установок

Из того же набора139

Весь набор →
openrouter-streaming-setup Скилл openrouter-streaming-setup для Claude Code, Codex, Cursor и других платформ реализует потоковые ответы через OpenRouter с Server-Sent Events. CX Codex +1 1установок evernote-core-workflow-a Скилл evernote-core-workflow-a для Claude Code создаёт заметки Evernote и управляет блокнотами и тегами в базовом рабочем процессе, включая форматирование ENML и группировку блокнотов в стеки. CX Codex +1 1установок backlog-grooming-assistant Скилл backlog-grooming-assistant помогает структурировать бэклог, готовит конфигурации задач и даёт пошаговые инструкции для груминга в enterprise-проектах. CX Codex +1 1установок long-polling-handler Автоматически помогает разбирать задачи long polling handler в API-интеграциях, писать конфигурации и проверять результат. CX Codex +1 1установок maintainx-webhooks-events Скилл maintainx-webhooks-events настраивает приём вебхуков MaintainX и обработку событий рабочих заказов в Express. Помогает связать обновления ТОиР с внешними сервисами. CX Codex +1 1установок lindy-webhooks-events Скилл lindy-webhooks-events для Claude Code подключает вебхук-триггеры Lindy AI и обратные вызовы приложения. Проверяет события, ставит их в очередь и обрабатывает повторные запросы. CX Codex +1 1установок fireflies-webhooks-events Скилл fireflies-webhooks-events проводит агента по сборке приёмника Fireflies Webhooks V2: проверка HMAC по сырому телу, белый список событий, дедупликация и быстрый ответ 2xx. CX Codex +1 1установок documenso-webhooks-events Скилл documenso-webhooks-events помогает настроить приём вебхуков сервиса Documenso. Пригодится при отслеживании подписания документов и передаче статусов во внешние сервисы. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой