Agent skill · design visual · jeremylongshore
figma-migration-deep-dive
Migrate design systems between Figma files, or from other tools to Figma
Why this skill is useful
Adds executable scripts for automating design system migrations in Figma that aren't available in public documentation.
What it needs
Requires bash 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 Migration Deep Dive Overview Automate migration of design data between Figma files, from other tools to Figma, or from Figma styles to the Variables API. Covers inventory, extraction, transformation, and validation. Prerequisites Source and destination Figma file keys FIGMAPAT with filecontent:read and filevariables:write (Enterprise) scopes Understanding of source file structure Instructions Step 1: Inventory Source File Step 2: Extract Styles from Source Step 3: Transform and Map to Target Step 4: Write to Target (Variables API) Step 5: Validation Output Source file inventoried (components, styles, nodes) Styles extracted and transformed to tokens Tokens written to target file via Variables API Migration validated with comparison report Error Handling Error Cause Solution ------- ------- ---------- 403 on Variables POST Not Enterprise Use JSON export instead of Variables API Duplicate variable names Name collision in target Add prefix/suffix to migrated names Missing node data Node deleted between fetch and read Re-fetch with error handling Large file timeout File >100MB Use /nodes endpoint for specific pages Examples Dry-run a styles→variables migration and review the mapping before writing (Steps 2-3): Then re-run without --dry-run to write via the Variables API and validate with Step 5 (GET /v1/files/{key}/variables/local count check). Transform rules: references/transform-and-map-to-target.md. Resources Figma Variables API Figma File Endpoints Design Tokens Format Next Steps For advanced troubleshooting, see figma-advanced-troubleshooting.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/figma-migration-deep-dive