Agent skill · software engineering · jeremylongshore
gamma-sdk-patterns
Reusable patterns for the Gamma REST API (no SDK exists).
Why this skill is useful
Adds production-grade TypeScript patterns for interacting with the Gamma REST API, including typed clients and error handling that are not available in public documentation.
What it needs
Requires typescript 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 API Patterns Output Produce a client-validation receipt with contract/fixture version, opaque operation ID, schema result, idempotency outcome, owner, and redacted failure reference. Do not log presentation content or tokens. Examples Use a scoped staging integration and fictional document to validate field allowlists and duplicate suppression. Reject an unknown destination before the provider call and retain only aggregate results. Overview Gamma has no published SDK — all interaction is via REST at https://public-api.gamma.app/v1.0/. This skill provides production-grade patterns for typed clients, generation helpers, polling, template workflows, and error handling. Prerequisites Completed gamma-install-auth setup TypeScript project with fetch (Node.js 18+) Understanding of the generate-poll-retrieve workflow Instructions Step 1: Typed Client Singleton Step 2: Custom Error Class Step 3: Poll-Until-Done Helper Step 4: Generate-and-Wait Convenience Step 5: Template-Based Generation Step 6: Retry with Backoff API Endpoints Reference Method Endpoint Purpose -------- ---------- --------- POST /v1.0/generations Generate from text content POST /v1.0/generations/from-template Generate from a template gamma GET /v1.0/generations/{id} Poll generation status GET /v1.0/generations/{id}/files Get export file URLs GET /v1.0/themes List workspace themes GET /v1.0/folders List workspace folders Error Handling Pattern Use Case --------- ---------- GammaApiError class Typed error handling with isRateLimit, isAuth, isServerError withRetry() Auto-retry on 429/5xx with exponential backoff pollUntilDone() Timeout-aware polling with configurable interval Singleton getGamma() Consistent config across modules Resources Gamma API Reference Generate API Parameters Create from Template Next Steps Proceed to gamma-core-workflow-a for content generation workflows.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/gamma-sdk-patterns