---

name: gamma-performance-tuning description: | Optimize Gamma API performance and reduce latency. Use when experiencing slow response times, optimizing throughput, or improving user experience with Gamma integrations. Trigger with phrases like "gamma performance", "gamma slow", "gamma latency", "gamma optimization", "gamma speed". allowed-tools: Read, Write, Edit version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io compatible-with: claude-code, codex, openclaw

Gamma Performance Tuning

Contents

• Overview
• Prerequisites
• Instructions
• Output
• Error Handling
• Examples
• Resources

Overview

Optimize Gamma API integration performance through client configuration, caching, connection pooling, and parallel request patterns.

Prerequisites

• Working Gamma integration
• Performance monitoring tools
• Understanding of caching concepts

Instructions

Step 1: Optimize Client Configuration

Enable keep-alive, compression, and configure max sockets (10). Set retry conditions for 5xx and 429 errors.

Step 2: Implement Response Caching

Use node-cache with 5-minute TTL. Invalidate on presentation.updated events.

Step 3: Parallelize Requests

Replace sequential loops with p-limit (concurrency 5) for bulk operations. Use batch API where available.

Step 4: Add Pagination with Generators

Use async generators for memory-efficient iteration over large presentation lists.

Step 5: Optimize Request Payloads

Request only needed fields to reduce response size. Use returnImmediately for creation operations.

Step 6: Configure Connection Pooling

Create shared HTTP/HTTPS agents with keep-alive, 25 max sockets, and 60s timeout.

See detailed implementation for advanced patterns.

Output

• Optimized client configuration
• Response caching layer
• Parallel request patterns
• Connection pooling setup
• Performance monitoring

Error Handling

| Issue | Cause | Solution | |-------|-------|----------| | High latency | No connection reuse | Enable keep-alive and pooling | | Memory growth | Unbounded cache | Set TTL and max cache size | | Rate limiting | Too many parallel requests | Use p-limit with concurrency cap |

Examples

Performance Targets

| Operation | Target | Action if Exceeded | |-----------|--------|-------------------| | Simple GET | < 200ms | Check network, use caching | | List (100 items) | < 500ms | Reduce page size | | Create presentation | < 5s | Use async pattern | | Export PDF | < 30s | Use webhook notification |

Resources

• Gamma Performance Guide
• Node.js Performance