vercel-webhooks-events — скилл для Claude Code
Скилл vercel-webhooks-events для Claude Code, Codex, Cursor и других платформ обрабатывает события развёртывания Vercel с проверкой подписи HMAC.
MIT 1 установок ★ 2 935 обновлён 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a claude-codeЧто делает vercel-webhooks-events
Скилл предоставляет готовый обработчик вебхуков с верификацией подписей через crypto модуль. Внутри — функции для обработки событий типа deployment.created, deployment.ready и deployment.error, отправка уведомлений в Slack при успешном развёртывании в production, обработка ошибок. Включает механизм идемпотентности, чтобы не обработать одно событие дважды при повторной отправке от Vercel.
Для работы нужны HTTPS-эндпоинт, доступный из интернета, и секрет вебхука из панели Vercel. Скилл использует @vercel/node для типизации запросов и ответов. Локально можно тестировать через localtunnel или другой туннель-сервис, отправляя curl-запросы с правильной подписью.
Скилл работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Способ установки зависит от платформы: для Claude Code и Cursor — команда npx skills add, для GitHub Copilot — gh skill install, для Gemini CLI — отдельная строка с путём репозитория.
Какие задачи решает
- настроить обработку вебхуков Vercel с проверкой подписи
- отправить уведомление в Slack при успешном развёртывании
- предотвратить дублирование обработки одного события
- протестировать вебхук локально перед развёртыванием
- различать события из Vercel Marketplace и project-level Deploy Hooks
Примеры запросов агенту
- Настрой обработку вебхуков Vercel с проверкой подписей в
api/webhooks/vercel.ts - Реализуй отправку сообщения в Slack при событии
deployment.readyдля production - Добавь механизм идемпотентности, чтобы не обработать один вебхук дважды
Как установить vercel-webhooks-events
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a claude-code2Вручную: положить файлы
~/.claude/skills/vercel-webhooks-events/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vercel-webhooks-events/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a codex2Вручную: положить файлы
.agents/skills/vercel-webhooks-events/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a cursor2Вручную: положить файлы
.cursor/skills/vercel-webhooks-events/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/vercel-webhooks-events2Вручную: положить файлы
.github/skills/vercel-webhooks-events/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/vercel-webhooks-eventsВручную: положить файлы
.devin/skills/vercel-webhooks-events/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vercel-webhooks-events
Как установить vercel-webhooks-events в Claude Code?
Выполни команду npx skills add jeremylongshore/tons-of-skills-marketplace --skill vercel-webhooks-events -a claude-code, затем открой файл ~/.claude/skills/vercel-webhooks-events/SKILL.md для просмотра деталей скилла.
Что делает vercel-webhooks-events?
Скилл обрабатывает события развёртывания Vercel (deployment.created, deployment.ready, deployment.error) с проверкой подписи HMAC-SHA1. Отправляет уведомления, предотвращает дублирование событий и предоставляет примеры интеграции со Slack.
На каких платформах работает этот скилл?
Скилл поддерживает Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Способ установки отличается: для одних — npx skills add, для других — gh skill install или прямая ссылка на репозиторий.
Исходный текст
SKILL.md · MIT
--- name: vercel-webhooks-events description: 'Implement Vercel webhook handling with signature verification and event processing. Use when setting up webhook endpoints, processing deployment events, or building integrations that react to Vercel deployment lifecycle. Trigger with phrases like "vercel webhook", "vercel events", "vercel deployment.ready", "handle vercel events", "vercel webhook signature". ' allowed-tools: Read, Write, Edit, Bash(curl:*) version: 1.18.0 license: MIT author: Jeremy Longshore <[email protected]> tags: - saas - vercel - webhooks - events - integration compatibility: Designed for Claude Code --- # Vercel Webhooks & Events ## Overview Handle Vercel webhook events (deployment.created, deployment.ready, deployment.error) with HMAC signature verification. Covers both integration webhooks (Vercel Marketplace) and project-level deploy hooks. ## Prerequisites - HTTPS endpoint accessible from the internet - Webhook secret from Vercel dashboard or integration settings - `crypto` module for HMAC signature verification ## Instructions ### Step 1: Register a Webhook In the Vercel dashboard: 1. Go to **Settings > Webhooks** 2. Add your endpoint URL (must be HTTPS) 3. Select events to subscribe to 4. Copy the webhook secret for signature verification Or for Integration webhooks, configure in the Integration Console at `vercel.com/dashboard/integrations`. ### Step 2: Verify Webhook Signature ```typescript // api/webhooks/vercel.ts import type { VercelRequest, VercelResponse } from '@vercel/node'; import crypto from 'crypto'; const WEBHOOK_SECRET = process.env.VERCEL_WEBHOOK_SECRET!; function verifySignature(body: string, signature: string): boolean { const expectedSignature = crypto .createHmac('sha1', WEBHOOK_SECRET) .update(body) .digest('hex'); return crypto.timingSafeEqual( Buffer.from(signature), Buffer.from(expectedSignature) ); } export default async function handler(req: VercelRequest, res: VercelResponse) { if (req.method !== 'POST') { return res.status(405).json({ error: 'Method not allowed' }); } // Get raw body for signature verification const rawBody = JSON.stringify(req.body); const signature = req.headers['x-vercel-signature'] as string; if (!signature || !verifySignature(rawBody, signature)) { return res.status(401).json({ error: 'Invalid signature' }); } // Process the event const event = req.body; await handleEvent(event); res.status(200).json({ received: true }); } ``` ### Step 3: Handle Deployment Events ```typescript // lib/webhook-handlers.ts interface VercelWebhookEvent { id: string; type: string; createdAt: number; payload: { deployment: { id: string; name: string; url: string; meta: Record<string, string>; }; project: { id: string; name: string; }; target: 'production' | 'preview' | null; user: { id: string; email: string; username: string }; }; } async function handleEvent(event: VercelWebhookEvent): Promise<void> { switch (event.type) { case 'deployment.created': console.log(`Deployment started: ${event.payload.deployment.url}`); // Notify Slack, update status board, etc. break; case 'deployment.ready': console.log(`Deployment ready: ${event.payload.deployment.url}`); // Run smoke tests against the deployment URL // Notify team of successful deploy if (event.payload.target === 'production') { await notifyProductionDeploy(event); } break; case 'deployment.error': console.error(`Deployment failed: ${event.payload.deployment.id}`); // Alert on-call engineer // Create incident ticket await notifyDeploymentError(event); break; case 'deployment.canceled': console.log(`Deployment canceled: ${event.payload.deployment.id}`); break; case 'project.created': console.log(`New project: ${event.payload.project.name}`); break; case 'project.removed': console.log(`Project removed: ${event.payload.project.name}`); break; default: console.log(`Unhandled event type: ${event.type}`); } } ``` ### Step 4: Idempotency — Prevent Duplicate Processing ```typescript // lib/idempotency.ts // Vercel may retry webhook delivery — track processed event IDs const processedEvents = new Set<string>(); // Use Redis in production async function processWebhookIdempotent( event: VercelWebhookEvent, handler: (e: VercelWebhookEvent) => Promise<void> ): Promise<boolean> { if (processedEvents.has(event.id)) { console.log(`Skipping duplicate event: ${event.id}`); return false; } await handler(event); processedEvents.add(event.id); return true; } ``` ### Step 5: Slack Notification Example ```typescript // lib/notifications.ts async function notifyProductionDeploy(event: VercelWebhookEvent): Promise<void> { const { deployment, project, user } = event.payload; await fetch(process.env.SLACK_WEBHOOK_URL!, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ text: `Production deploy complete`, blocks: [ { type: 'section', text: { type: 'mrkdwn', text: [ `*${project.name}* deployed to production`, `By: ${user.username}`, `URL: https://${deployment.url}`, `Commit: ${deployment.meta?.githubCommitMessage ?? 'N/A'}`, ].join('\n'), }, }, ], }), }); } async function notifyDeploymentError(event: VercelWebhookEvent): Promise<void> { await fetch(process.env.SLACK_WEBHOOK_URL!, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ text: `Deployment FAILED for ${event.payload.project.name} — ${event.payload.deployment.id}`, }), }); } ``` ### Step 6: Test Webhooks Locally ```bash # Use the Vercel CLI to test webhook signatures # Or use a tunnel service for local testing npx localtunnel --port 3000 # Gives you a public URL like https://xxx.loca.lt # Send a test webhook payload curl -X POST http://localhost:3000/api/webhooks/vercel \ -H "Content-Type: application/json" \ -H "x-vercel-signature: $(echo -n '{"type":"deployment.ready","id":"test"}' | openssl dgst -sha1 -hmac 'your-secret' | awk '{print $2}')" \ -d '{"type":"deployment.ready","id":"test"}' ``` ## Webhook Event Types | Event | Trigger | |-------|---------| | `deployment.created` | New deployment started building | | `deployment.ready` | Deployment build completed successfully | | `deployment.error` | Deployment build failed | | `deployment.canceled` | Deployment was canceled | | `project.created` | New project created | | `project.removed` | Project deleted | | `domain.created` | Domain added to project | | `integration.configuration.removed` | Integration uninstalled | ## Output - Webhook endpoint with HMAC signature verification - Event handlers for deployment lifecycle events - Idempotent processing preventing duplicates - Slack notifications for production deploys and failures ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | `401 Invalid signature` | Wrong webhook secret or body mismatch | Verify secret matches dashboard, use raw body for HMAC | | Webhook not received | Endpoint not publicly accessible | Ensure HTTPS, check firewall rules | | Duplicate processing | Webhook retried by Vercel | Implement idempotency with event ID tracking | | `504 timeout` on webhook endpoint | Handler takes too long | Return 200 immediately, process async in background | | Missing `x-vercel-signature` | Not a real Vercel webhook | Reject requests without the signature header | ## Examples ### Process a deployment webhook exactly once Verify the raw-body HMAC signature before parsing the event, reject absent or invalid signatures with a generic response, and persist the event ID in an idempotency store before any side effect. Acknowledge quickly and hand longer work to a controlled background queue. Test duplicate delivery and an invalid signature with synthetic events in preview, and keep notification payloads free of tokens, environment values, and customer request data. ## Resources - [Vercel Webhooks API](https://vercel.com/docs/webhooks/webhooks-api) - [Setting Up Webhooks](https://vercel.com/docs/webhooks) - [Deploy Hooks](https://vercel.com/docs/deploy-hooks) - [Integration Webhooks](https://vercel.com/docs/integrations/create-integration) ## Next Steps For performance optimization, see `vercel-performance-tuning`.
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace