understand-figma

Analyze a Figma file via the Figma REST API and generate an interactive design knowledge graph.

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/danieliudi/trackforge-os --skill understand-figma-danieliudi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: understand-figma
Source: https://github.com/danieliudi/trackforge-os/tree/main/.cursor/skills/understand-figma
Command: npx skills add https://github.com/danieliudi/trackforge-os --skill understand-figma-danieliudi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @understand-anything/core, and includes scripts (resource) components.

What problem does it solve? Design teams struggle to keep a structured, queryable view of large Figma files. This Skill turns a Figma file into an interactive design knowledge graph covering pages, screens, components, component sets, instances, and design tokens, so the structure of a design system can be explored in a dashboard instead of manually clicking through the file. ## Core Features & Use Cases - Figma REST API Scanning: Fetches the document, styles, and screen thumbnails using a personal access token, with incremental re-runs that skip unchanged file versions. - LLM-Enriched Analysis: Batches parsed nodes through a design-analyzer subagent to add semantic descriptions, then merges everything into a validated knowledge graph. - Dashboard Visualization: Produces a kind:"design" knowledge graph with layers and guided tour steps, launched in the existing understand dashboard. - Use Case: Point the Skill at a design-system Figma file URL to generate a navigable graph of every screen, component, and token, then share the dashboard with engineers who need to understand the design without Figma access. ## Quick Start Ask the assistant to run /understand-figma with your Figma file URL after exporting a FIGMA_TOKEN environment variable.

Frequently Asked Questions about understand-figma

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a Figma file from the command line?

Run the understand-figma skill with a Figma file URL or file key as the argument. It calls the Figma REST API, parses the document into nodes and edges, enriches them with LLM analysis, and writes a knowledge-graph.json consumed by the dashboard.

What do I need to connect to the Figma REST API?

You need a Figma personal access token created at figma.com/settings, exported as the FIGMA_TOKEN environment variable. The token is sent only in the X-Figma-Token request header to api.figma.com and is never written to files or logs.

Does re-running the Figma scan reprocess the whole file?

No. The scan compares the Figma file version against the stored meta.json and exits with UP_TO_DATE when unchanged, only refreshing expired pre-signed screen thumbnail URLs. Set UNDERSTAND_FIGMA_FORCE=1 to force a full rebuild.

Why are my Figma screen thumbnails broken in the dashboard?

Screen thumbnail URLs returned by the Figma API are pre-signed and expire after a few hours. Re-running the scan refreshes them in place in the existing knowledge graph without re-analyzing the file.

What are the limitations of Figma design graph analysis?

The skill requires network access to api.figma.com, so it is not fully offline. Thumbnail rendering is best-effort and never blocks the scan, and failed LLM analysis batches are skipped with a warning, leaving the structural manifest as the base graph.