Agent skill · software engineering · jeremylongshore
gamma-common-errors
Debug and resolve common Gamma API errors.
Why this skill is useful
Provides specific error handling patterns and debugging scripts for the Gamma API that the AI wouldn't reliably generate on its own.
What it needs
Requires gamma account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Gamma Common Errors Instructions Classify the failure as access, content generation, publish/share, integration, quota, or availability; reproduce safely in staging; apply the smallest reversible correction; verify recovery and safe failure behavior. Output Return an opaque correlation ID, error category, corrective action, verification, owner, and follow-up. Keep private content, viewer details, and credentials out of evidence. Error Handling Pause sharing/publishing on permission, destination, or privacy failures; use bounded retries for transient errors and rollback before replaying content actions. Examples Use a fictional presentation to trigger a controlled publish error, restore the staging configuration, and verify no external audience received content. Overview Reference guide for debugging and resolving common Gamma API errors. Prerequisites Active Gamma integration Access to logs and error messages Understanding of HTTP status codes Error Reference Authentication Errors (401/403) Solutions: 1. Verify API key in Gamma dashboard 2. Check environment variable is set: echo $GAMMAAPIKEY 3. Ensure key hasn't been rotated 4. Check for trailing whitespace in key Rate Limit Errors (429) Solutions: 1. Implement exponential backoff 2. Check rate limit headers: X-RateLimit-Remaining 3. Upgrade plan for higher limits 4. Queue requests with delays Generation Errors (400/500) Solutions: 1. Simplify prompt or reduce slide count 2. Remove special characters from content 3. Check content length limits 4. Try different style setting Timeout Errors Solutions: 1. Increase client timeout setting 2. Use async job pattern for large presentations 3. Check network connectivity 4. Reduce request complexity Export Errors Solutions: 1. Verify presentation exists and is complete 2. Check supported export formats 3. Ensure no pending generation jobs 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/gamma-common-errors