Agent skill · data analytics · jeremylongshore
figma-common-errors
Diagnose and fix common Figma REST API and Plugin API errors.
Why this skill is useful
Provides specific troubleshooting commands and solutions for common Figma API errors that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, jq installed locally. Requires figma account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Figma Common Errors Overview Quick reference for the most common Figma REST API and Plugin API errors, with exact error messages and working solutions. Prerequisites Figma API credentials configured Access to your application logs or browser console Instructions Step 1: Identify the Error Category REST API HTTP Errors Status Error Cause Solution -------- ------- ------- ---------- 400 Bad Request Malformed request, invalid node IDs Verify node ID format (pageId:nodeId, e.g., 0:1) 403 Forbidden Invalid token, wrong scopes, no file access Regenerate PAT with correct scopes; verify file sharing 404 Not Found Wrong file key, deleted file, wrong endpoint Check file key from URL; verify file exists 429 Rate Limited Too many requests Read Retry-After header; implement backoff 500 Internal Server Error Figma server issue Retry with exponential backoff; check status.figma.com Step 2: Diagnose Specific Errors 403 Forbidden -- Token Issues Common 403 causes: PAT expired (90-day maximum lifetime) Token missing required scope (e.g., using filecontent:read but calling comments endpoint) File not shared with the token owner OAuth token not refreshed after expiry 429 Rate Limited 404 Not Found Images Endpoint Returns null Step 3: Plugin API Errors Error Context Cause Solution ------- --------- ------- ---------- figma is not defined Node.js / browser Running plugin code outside Figma sandbox Plugin code only runs inside Figma desktop app Cannot read property of undefined Plugin Accessing deleted node reference Re-query node: figma.getNodeById(id) Plugin timed out Plugin Operation took too long Use figma.commitUndo() and batch operations Quota exceeded Plugin Too many nodes created Limit to ~5000 nodes per operation Permission denied Plugin Missing manifest.json permission Add required permission to permissions array Step 4: Quick Diagnostic Script Output Identified error cause from status code and headers Applied targeted fix Verified resolution with diagnostic commands Error Handl …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/figma-common-errors