Agent skill · data analytics · jeremylongshore
figma-debug-bundle
Collect Figma API diagnostic evidence for support tickets and troubleshooting.
Why this skill is useful
Adds an executable script that automates the collection of Figma API diagnostic data, which is not commonly available in public documentation.
What it needs
Requires curl, jq installed locally. Requires figma account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Figma Debug Bundle Overview Collect all diagnostic data needed to troubleshoot Figma REST API issues or submit a support request. Outputs a redacted archive with connectivity tests, token validation, rate limit status, and API response samples. Prerequisites FIGMAPAT environment variable set curl and jq available A Figma file key to test against Instructions Step 1: Create Debug Bundle Script Step 2: Run the Bundle Step 3: Review Before Sharing Output figma-debug-YYYYMMDD-HHMMSS.tar.gz containing: summary.txt -- environment, connectivity, rate limit status me-redacted.json -- authenticated user (email redacted) file-meta.json -- file metadata (if file key provided) Error Handling Item What It Catches Why It Matters ------ ---------------- ---------------- /v1/me response code Token validity 403 = expired/invalid PAT /v1/files response code File access 404 = wrong key, 403 = not shared Rate limit headers Throttling state Retry-After shows if currently limited Response time Latency issues >2s suggests network or server problems Examples ALWAYS REDACT Before Sharing Personal access tokens (figd) Email addresses OAuth client secrets File content (unless relevant to the bug) Safe to Include HTTP status codes and response times Error message text Node IDs and file keys (not secrets) Rate limit header values Resources Figma Support Figma Status Page Figma Developer Forum Next Steps For rate limit issues, see figma-rate-limits.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/figma-debug-bundle--f857b0