Skip to content
Skills Library
Programming · Analysis

gamma-debug-bundle

/gamma-debug-bundle

Comprehensive debugging toolkit for Gamma integration issues. Use when you need detailed diagnostics, request tracing, or systematic debugging of Gamma API problems. Trigger with phrases like "gamma debug bundle", "gamma diagnostics", "gamma trace", "gamma inspect", "gamma detailed logs".

Repository
agent ↗
Licence
MIT
Last repository change
14.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Comprehensive debugging toolkit for Gamma integration issues. Use when you need detailed diagnostics, request tracing, or systematic debugging of Gamma API problems. Trigger with phrases like "gamma debug bundle", "gamma diagnostics", "gamma trace", "gamma inspect", "gamma detailed logs".

Triggers from the description

gamma debug bundlegamma diagnosticsgamma tracegamma inspectgamma detailed logs
Original author description

Comprehensive debugging toolkit for Gamma integration issues. Use when you need detailed diagnostics, request tracing, or systematic debugging of Gamma API problems. Trigger with phrases like "gamma debug bundle", "gamma diagnostics", "gamma trace", "gamma inspect", "gamma detailed logs".

How it works

  1. Overview
  2. Prerequisites
  3. Instructions
  4. Output
  5. Resources
  6. Next Steps
Original SKILL.md headings · 203 lines, 538 words
SKILL.md preview
---
name: gamma-debug-bundle
description: |
  Comprehensive debugging toolkit for Gamma integration issues.
  Use when you need detailed diagnostics, request tracing,
  or systematic debugging of Gamma API problems.
  Trigger with phrases like "gamma debug bundle", "gamma diagnostics",
  "gamma trace", "gamma inspect", "gamma detailed logs".
allowed-tools: Read, Write, Edit, Bash(node:*), Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
---

# Gamma Debug Bundle

## Overview
Comprehensive debugging toolkit for systematic troubleshooting of Gamma integration issues.

## Prerequisites
- Active Gamma integration with issues
- Node.js 18+ for debug tools
- Access to application logs

## Instructions

### Step 1: Create Debug Client
```typescript
// debug/gamma-debug.ts
import { GammaClient } from '@gamma/sdk';

interface DebugLog {
  timestamp: string;
  method: string;
  path: string;
  requestBody?: object;
  responseBody?: object;
  duration: number;
  status: number;
  error?: string;
}

const logs: DebugLog[] = [];

export function createDebugClient() {
  const gamma = new GammaClient({
    apiKey: process.env.GAMMA_API_KEY,
    interceptors: {
      request: (config) => {
        config._startTime = Date.now();
        config._id = crypto.randomUUID();
        console.log(`[${config._id}] -> ${config.method} ${config.path}`);
        return config;
      },
      response: (response, config) => {
        const duration = Date.now() - config._startTime;
        console.log(`[${config._id}] <- ${response.status} (${duration}ms)`);

        logs.push({
          timestamp: new Date().toISOString(),
          method: config.method,
          path: config.path,
          requestBody: config.body,
          responseBody: response.data,
          duration,
          status: response.status,
        });

        return response;
      },
      error: (error, config) => {
        const duration = Date.now() - config._startTime;
        console.error(`[${config._id}] !! ${error.message} (${duration}ms)`);

        logs.push({
          timestamp: new Date().toISOString(),
          method: config.method,
          path: config.path,
          requestBody: config.body,
          duration,
          status: error.status || 0,
          error: error.message,
        });

        throw error;
      },
    },
  });

  return { gamma, getLogs: () => [...logs], clearLogs: () => logs.length = 0 };
}
```

### Step 2: Diagnostic Script
```typescript
// debug/diagnose.ts
import { createDebugClient } from './gamma-debug';

async function diagnose() {
  const { gamma, getLogs } = createDebugClient();

  console.log('=== Gamma Diagnostic Report ===\n');

  // Test 1: Authentication
  console.log('1. Testing Authentication...');
  try {
    await gamma.ping();
    console.log('   OK - Authentication working\n');
  } catch (err) {
    console.log(`   FAIL - ${err.message}\n`);
    return;
  }

  // Test 2: API Access
  console.log('2. Testing API Access...');
  try {
    const presentations = await gamma.presentations.list({ limit: 1 });
    console.log(`   OK - Can list presentations (${presentations.length} found)\n`);
  } catch (err) {
    console.log(`   FAIL - ${err.message}\n`);
  }

  // Test 3: Generation Capability
  console.log('3. Testing Generation...');
  try {
    const test = await gamma.presentations.create({
      title: 'Debug Test',
      prompt: 'Single test slide',
      slideCount: 1,
      dryRun: true,
    });
    console.log('   OK - Generation endpoint working\n');
  } catch (err) {
    console.log(`   FAIL - ${err.message}\n`);
  }

  // Test 4: Rate Limits
  console.log('4. Checking Rate Limits...');
  const status = await gamma.rateLimit.status();
  console.log(`   Remaining: ${status.remaining}/${status.limit}`);
  console.log(`   Resets: ${new Date(status.reset * 1000).toISOString()}\n`);

  // Summary
  console.log('=== Request Log ===');
  for (const log of getLogs()) {
    console.log(`${log.method} ${log.path} - ${log.status} (${log.duration}ms)`);
  }
}

diagnose().catch(console.error);
```

### Step 3: Environment Checker
```typescript
// debug/check-env.ts
function checkEnvironment() {
  const checks = [
    { name: 'GAMMA_API_KEY', value: process.env.GAMMA_API_KEY },
    { name: 'NODE_ENV', value: process.env.NODE_ENV },
    { name: 'Node Version', value: process.version },
  ];

  console.log('=== Environment Check ===\n');

  for (const check of checks) {
    const status = check.value ? 'SET' : 'MISSING';
    const display = check.value
      ? check.value.substring(0, 8) + '...'
      : 'NOT SET';
    console.log(`${check.name}: ${status} (${display})`);
  }
}

checkEnvironment();
```

### Step 4: Export Debug Bundle
```typescript
// debug/export-bundle.ts
async function exportDebugBundle() {
  const bundle = {
    timestamp: new Date().toISOString(),
    environment: {
      nodeVersion: process.version,
      platform: process.platform,
      env: process.env.NODE_ENV,
    },
    logs: getLogs(),
    config: {
      apiKeySet: !!process.env.GAMMA_API_KEY,
      timeout: 30000,
    },
  };

  await fs.writeFile(
    'gamma-debug-bundle.json',
    JSON.stringify(bundle, null, 2)
  );

  console.log('Debug bundle exported to gamma-debug-bundle.json');
}
```

## Output
- Debug client with request tracing
- Diagnostic script output
- Environment check report
- Exportable debug bundle

## Resources
- [Gamma Debug Guide](https://gamma.app/docs/debugging)
- [Gamma Support Portal](https://gamma.app/support)

## Next Steps
Proceed to `gamma-rate-limits` for rate limit management.

Versions

The database has no other skills named gamma-debug-bundle.

Database snapshot: 13.11.2026 · package version 51a471dd848f (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-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".
  • 100maintainx-debug-bundle
    Comprehensive debugging toolkit for MaintainX integrations. Use when experiencing complex issues, need detailed logging, or troubleshooting integration problems with MaintainX. Trigger with phrases like "debug maintainx", "maintainx troubleshoot", "maintainx detailed logs",…
  • 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.
  • 100documenso-debug-bundle
    Comprehensive debugging toolkit for Documenso integrations. Use when troubleshooting complex issues, gathering diagnostic information, or creating support tickets for Documenso problems. Trigger with phrases like "debug documenso", "documenso diagnostics", "troubleshoot…
  • 100gamma-shift
    Work through the tickets waiting on the user. Use when the user says "gamma shift", "follow-ups" or "what's waiting on me", and when the session-start hook asks for a gamma-shift count or run.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.