Gamma Presentations

Gamma Presentations Skill

Generate professional presentations with expert storytelling consulting based on Duarte methodology.

⚠️ Staleness Watch (Last validated: Mar 2026 — API v1.0 GA): Check developers.gamma.app for endpoint changes and pricing updates. See also EXTERNAL-API-REGISTRY.md.

Slide Break Rules

When using cardSplit: "inputTextBreaks", each \n---\n marks a card break:

# Title Slide
Content

---

# Second Slide
More content

• cardSplit: "inputTextBreaks" — Gamma uses --- breaks (ignores numCards)
• cardSplit: "auto" (default) — Gamma uses numCards (ignores --- breaks)

Prerequisites

• Gamma account (all plans have API access)
• API key from gamma.app/settings
• Environment variable: GAMMA_API_KEY

Pricing Tiers

Rate limit: 50 requests/hour.

API Quick Reference

Base URL: https://public-api.gamma.app

Auth: X-API-KEY: <your-api-key>

Generate Parameters

Required

Format Options

Text Options

"textOptions": {
  "amount": "medium",      // brief, medium, detailed, extensive
  "tone": "professional",  // 1-500 chars
  "audience": "executives", // 1-500 chars
  "language": "en"         // 60+ languages
}

Image Options

"imageOptions": {
  "source": "aiGenerated",  // aiGenerated, pictographic, pexels, giphy, webAllImages, webFreeToUse, webFreeToUseCommercially, placeholder, noImages
  "model": "flux-2-pro",    // see models below
  "style": "modern, minimal" // 1-500 chars
}

Card Options

"cardOptions": {
  "dimensions": "16x9",  // Presentation: fluid, 16x9, 4x3 | Document: fluid, pageless, letter, a4 | Social: 1x1, 4x5, 9x16
  "headerFooter": {
    "topRight": { "type": "image", "source": "themeLogo", "size": "sm" },
    "bottomRight": { "type": "cardNumber" },
    "bottomLeft": { "type": "text", "value": "© 2026 Company" },
    "hideFromFirstCard": true,
    "hideFromLastCard": true
  }
}

Positions: topLeft, topRight, topCenter, bottomLeft, bottomRight, bottomCenter Types: text (+ value), image (+ source, size), cardNumber

Sharing Options

"sharingOptions": {
  "workspaceAccess": "view",     // noAccess, view, comment, edit, fullAccess
  "externalAccess": "noAccess",  // noAccess, view, comment, edit
  "emailOptions": {
    "recipients": ["user@example.com"],
    "access": "comment"
  }
}

Export

"exportAs": "pptx"  // or "pdf"

AI Image Models

Free Tier (2-10 cr)

Plus Tier (3-34 cr)

Pro Tier (20-50 cr)

Ultra Tier (30-125 cr)

Video Models (Ultra only)

Deprecated (auto-redirect)

Create from Template (Beta)

POST /v1.0/generations/from-template

Response Handling

POST Response

{ "generationId": "gen_abc123", "status": "pending" }

GET Completed

{
  "generationId": "gen_abc123",
  "status": "completed",
  "gammaUrl": "https://gamma.app/docs/xyz",
  "pptxUrl": "https://...",
  "pdfUrl": "https://...",
  "creditsUsed": 45
}

Polling Pattern

async function waitForGeneration(generationId, apiKey) {
  const maxAttempts = 30; // 60s for images, 300 for video
  const delayMs = 2000;
  for (let i = 0; i < maxAttempts; i++) {
    const res = await fetch(`https://public-api.gamma.app/v1.0/generations/${generationId}`,
      { headers: { 'X-API-KEY': apiKey } });
    const data = await res.json();
    if (data.status === 'completed') return data;
    if (data.status === 'failed') throw new Error(data.error);
    await new Promise(r => setTimeout(r, delayMs));
  }
  throw new Error('Generation timeout');
}

Example Request

curl -X POST https://public-api.gamma.app/v1.0/generations \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: sk-gamma-xxx' \
  -d '{
    "inputText": "Our startup solves remote collaboration with AI-powered async video.",
    "textMode": "generate",
    "format": "presentation",
    "numCards": 12,
    "textOptions": { "tone": "confident, visionary", "audience": "investors" },
    "imageOptions": { "source": "aiGenerated", "model": "flux-2-pro" },
    "cardOptions": { "dimensions": "16x9" },
    "exportAs": "pptx"
  }'

MCP Integration

Gamma provides a hosted MCP server (Claude, Make, Zapier, Workato, N8N).

Troubleshooting

CLI Script

Location: .github/muscles/gamma-generator.cjs

# From file with export + auto-open
node .github/muscles/gamma-generator.cjs -f README.md -e pptx --open -n 12 -d 16x9

# Draft workflow (no credits)
node .github/muscles/gamma-generator.cjs -t "AI Ethics" --draft --open
node .github/muscles/gamma-generator.cjs -f exports/ai-ethics-draft.md -e pptx --open -n 12 -d 16x9

⚠️ Critical: For file-based generation, always pass both --slides and --dimensions 16x9. Without --slides, Gamma can condense multiple sections into fewer slides. Without --dimensions, Gamma may default to fluid layout.

Related

• .github/instructions/gamma-presentation.instructions.md — Auto-activation rules