Agent skill · software engineering · jeremylongshore
figma-multi-env-setup
Configure Figma API access across dev, staging, and production environments.
Why this skill is useful
Adds specific configuration patterns and environment management strategies for Figma API that the AI wouldn't reliably generate on its own.
What it needs
Requires gcloud, vault 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 Multi-Environment Setup Overview Configure separate Figma API credentials and file targets per environment. Use different PATs with minimal scopes, point to different Figma files, and prevent accidental production operations from dev. Prerequisites Separate Figma PATs for each environment Secret management solution Environment detection in application Instructions Step 1: Environment Strategy Environment PAT Scopes Figma File Cache TTL ------------- ----------- ------------ ----------- Development filecontent:read Copy of design file 10s (fast iteration) Staging filecontent:read, filecomments:read Staging branch/file 60s Production filecontent:read, webhooks:write Production design file 300s Step 2: Configuration by Environment Step 3: Environment Files Step 4: Secret Management Step 5: Environment Guards Output Per-environment Figma configuration Secrets stored in appropriate secret managers Environment guards preventing cross-env mistakes Template env files for team onboarding Error Handling Issue Cause Solution ------- ------- ---------- Wrong file in dev Using prod file key Verify FIGMAFILEKEYDEV PAT expired in CI 90-day expiry Set rotation reminder per environment Staging webhook pointing to prod Wrong endpoint URL Verify webhook endpoint per env Config not loading Missing NODEENV Set NODEENV in deployment config Examples Point the same integration at a staging file locally and the production file in CI using the Step 2 config loader: Verify the guard refuses a cross-environment mistake before any API call is made: Environment strategy and per-env webhook registration (POST /v2/webhooks per environment): references/configuration-by-environment.md and references/environment-guards.md. Resources Figma Authentication 12-Factor App Config GitHub Environments Next Steps For observability setup, see figma-observability.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/figma-multi-env-setup