Agent skill · operations · jeremylongshore
figma-incident-runbook
Respond to Figma API outages, auth failures, and rate limit incidents.
Why this skill is useful
Adds executable scripts for rapid incident response to Figma API outages that are not publicly documented.
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 Incident Runbook Overview Rapid incident response procedures for Figma REST API integration failures. Covers triage, mitigation, and postmortem for the most common failure modes. Prerequisites Access to application logs and metrics Figma PAT for health checks Communication channel (Slack, PagerDuty) Instructions Step 1: Quick Triage (First 5 Minutes) Step 2: Decision Tree Step 3: Immediate Mitigation For 403 (Token Expired): For 429 (Rate Limited): For 500/503 (Figma Down): Step 4: Communication Step 5: Postmortem Template Output Issue identified via triage script Root cause determined from decision tree Mitigation applied (token rotation, fallback mode, etc.) Stakeholders notified Postmortem documented Error Handling Issue Cause Solution ------- ------- ---------- Can't reach status.figma.com Network issue Try from different network or mobile Triage script fails PAT not set Set FIGMAPAT before running Fallback data stale Last cache too old Set up regular cache refresh Alert not firing Missing metrics Verify Prometheus scrape config Examples Triage "the design token sync is failing" in under a minute (Step 1): /v1/me file probe Read as ---------- ----------- --------- 200 200 Our pipeline bug — not an API incident 200 403/404 File access changed — check sharing/scopes 401 any Token revoked or expired — rotate now 429 / 5xx 429 / 5xx Figma-side — mitigate per Step 3, check status.figma.com Decision tree and mitigation actions: references/decision-tree.md, references/immediate-mitigation.md; postmortem scaffold: references/postmortem-template.md. Resources Figma Status Page Figma Support Figma Developer Forum Next Steps For data handling, see figma-data-handling.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/figma-incident-runbook--d831e3