gamma-common-errors
/gamma-common-errors
Debug and resolve common Gamma API errors. Use when encountering authentication failures, rate limits, generation errors, or unexpected API responses. Trigger with phrases like "gamma error", "gamma not working", "gamma API error", "gamma debug", "gamma troubleshoot".
- Author
- HelixDevelopment ↗
- Repository
- agent ↗
- Licence
- MIT
- Last repository change
- 14.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Debug and resolve common Gamma API errors. Use when encountering authentication failures, rate limits, generation errors, or unexpected API responses. Trigger with phrases like "gamma error", "gamma not working", "gamma API error", "gamma debug", "gamma troubleshoot".
Triggers from the description
Original author description
Debug and resolve common Gamma API errors. Use when encountering authentication failures, rate limits, generation errors, or unexpected API responses. Trigger with phrases like "gamma error", "gamma not working", "gamma API error", "gamma debug", "gamma troubleshoot".
How it works
- Overview
- Prerequisites
- Error Reference
- Debugging Tools
- Error Handling Pattern
- Resources
- Next Steps
SKILL.md preview
---
name: gamma-common-errors
description: |
Debug and resolve common Gamma API errors.
Use when encountering authentication failures, rate limits,
generation errors, or unexpected API responses.
Trigger with phrases like "gamma error", "gamma not working",
"gamma API error", "gamma debug", "gamma troubleshoot".
allowed-tools: Read, Write, Edit, Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
---
# Gamma Common Errors
## 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)
```typescript
// Error: Invalid API Key
{
"error": "unauthorized",
"message": "Invalid or expired API key"
}
```
**Solutions:**
1. Verify API key in Gamma dashboard
2. Check environment variable is set: `echo $GAMMA_API_KEY`
3. Ensure key hasn't been rotated
4. Check for trailing whitespace in key
### Rate Limit Errors (429)
```typescript
// Error: Rate Limited
{
"error": "rate_limited",
"message": "Too many requests",
"retry_after": 60
}
```
**Solutions:**
1. Implement exponential backoff
2. Check rate limit headers: `X-RateLimit-Remaining`
3. Upgrade plan for higher limits
4. Queue requests with delays
```typescript
async function withRetry(fn: () => Promise<any>, maxRetries = 3) {
for (let i = 0; i < maxRetries; i++) {
try {
return await fn();
} catch (err) {
if (err.code === 'rate_limited' && i < maxRetries - 1) {
const delay = (err.retryAfter || Math.pow(2, i)) * 1000;
await new Promise(r => setTimeout(r, delay));
continue;
}
throw err;
}
}
}
```
### Generation Errors (400/500)
```typescript
// Error: Generation Failed
{
"error": "generation_failed",
"message": "Unable to generate presentation",
"details": "Content too complex"
}
```
**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
```typescript
// Error: Request Timeout
{
"error": "timeout",
"message": "Request timed out after 30000ms"
}
```
**Solutions:**
1. Increase client timeout setting
2. Use async job pattern for large presentations
3. Check network connectivity
4. Reduce request complexity
```typescript
const gamma = new GammaClient({
apiKey: process.env.GAMMA_API_KEY,
timeout: 60000, // 60 seconds
});
```
### Export Errors
```typescript
// Error: Export Failed
{
"error": "export_failed",
"message": "Unable to export presentation",
"format": "pdf"
}
```
**Solutions:**
1. Verify presentation exists and is complete
2. Check supported export formats
3. Ensure no pending generation jobs
4. Try exporting with lower quality setting
## Debugging Tools
### Enable Debug Logging
```typescript
const gamma = new GammaClient({
apiKey: process.env.GAMMA_API_KEY,
debug: true, // Logs all requests/responses
});
```
### Check API Status
```typescript
const status = await gamma.status();
console.log('API Status:', status.healthy ? 'OK' : 'Issues');
console.log('Services:', status.services);
```
## Error Handling Pattern
```typescript
import { GammaError, RateLimitError, AuthError } from '@gamma/sdk';
try {
const result = await gamma.presentations.create({ ... });
} catch (err) {
if (err instanceof AuthError) {
console.error('Check your API key');
} else if (err instanceof RateLimitError) {
console.error(`Retry after ${err.retryAfter}s`);
} else if (err instanceof GammaError) {
console.error('API Error:', err.message);
} else {
throw err;
}
}
```
## Resources
- [Gamma Status Page](https://status.gamma.app)
- [Gamma Error Codes](https://gamma.app/docs/errors)
- [Gamma Support](https://gamma.app/support)
## Next Steps
Proceed to `gamma-debug-bundle` for comprehensive debugging tools.
Versions
The database has no other skills named gamma-common-errors.
Database snapshot: 13.11.2026 · package version a9d572c4c5b0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100gamma-install-auth
Install and configure Gamma API authentication. Use when setting up a new Gamma integration, configuring API keys, or initializing Gamma in your project. Trigger with phrases like "install gamma", "setup gamma", "gamma auth", "configure gamma API key". - 100gamma-rate-limits
Understand and manage Gamma API rate limits effectively. Use when hitting rate limits, optimizing API usage, or implementing request queuing systems. Trigger with phrases like "gamma rate limit", "gamma quota", "gamma 429", "gamma throttle", "gamma request limits". - 100maintainx-common-errors
Debug and resolve common MaintainX API errors. Use when encountering API errors, authentication issues, or unexpected responses from the MaintainX API. Trigger with phrases like "maintainx error", "maintainx 401", "maintainx api problem", "maintainx not working", "debug maintainx". - 100anima-common-errors
Diagnose and fix common Anima SDK design-to-code errors. Use when encountering Figma token errors, code generation failures, node not found issues, or output quality problems. Trigger with: "anima error", "anima not working", "anima debug", "figma to code error". - 100gamma
Create presentations, documents, social posts, and websites using Gamma's AI API. Use when asked to create slides, presentations, decks, documents, or web content via Gamma.