Agent skill · software engineering · jeremylongshore
gamma-webhooks-events
Handle Gamma webhooks and events for real-time updates.
Why this skill is useful
Provides specific implementation patterns and event handling for Gamma's API that the AI wouldn't reliably generate on its own.
What it needs
Requires gamma-sdk installed locally. Requires gamma account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Gamma Webhooks & Events Output Return opaque event ID, validation outcome, idempotency result, destination status, and redacted error category. Keep event payloads and credentials out of logs. Examples Deliver a fictional event twice, process the first once, record the second as duplicate, and reject an unknown destination before content is forwarded. Overview Gamma's public API (v1.0) is generation-focused and does not expose a traditional webhook system at time of writing. Instead, use the poll-based pattern (GET /v1.0/generations/{id}) to detect completion. For event-driven architectures, wrap polling in a background worker that emits application-level events when generations complete or fail. Prerequisites Completed gamma-sdk-patterns setup Event bus or message queue (Bull, RabbitMQ, or EventEmitter) Understanding of the generate-poll-retrieve pattern Gamma Event Model (Application-Level) Since Gamma does not push events, you create them by polling: Synthetic Event Trigger Condition Use Case ----------------- ------------------- ---------- generation.started POST /generations returns generationId Log, notify user generation.completed Poll returns status: "completed" Download export, update DB generation.failed Poll returns status: "failed" Alert, retry, notify user generation.timeout Poll exceeds max duration Alert, escalate Instructions Step 1: Event Emitter Pattern Step 2: Event Listeners Step 3: Background Worker with Bull Queue Step 4: Webhook-Style HTTP Callback (DIY) If you want true webhook-style push notifications for integrations: Error Handling Issue Cause Solution ------- ------- ---------- Poll timeout Generation taking too long Increase timeout beyond 3 min for complex content Missed completion Poll interval too large Use 5s interval (Gamma recommendation) Duplicate processing No idempotency check Track processed generationIds in a Set or DB Export URL expired Downloaded too late Download immediately on completion Resources Gamma API Reference Poll …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/gamma-webhooks-events--591135