figma-extractor

# Figma Extractor Extract design tokens, styles, component metadata, and screen structure from Figma files. Process: **CHECK → PARSE → DISCOVER → EXTRACT → ORGANIZE** Every extracted value carries a source tag — downstream consumers use this for conflict resolution priority. A variable definition is stronger evidence than an inferred applied style. ## Extraction Levels Not every workflow needs every tool. Three levels control extraction depth: ``` Level 1 (Quick): whoami → get_metadata → get_variable_defs → get_design_context → get_screenshot Fast, read-only MCP tools. No Plugin API. Level 2 (Deep): Level 1 + use_figma read-only scripts Adds: collections with modes, codeSyntax, scopes, aliasing chains, text styles, effect styles, paint styles. Level 3 (Targeted): Level 2 + search_design_system + get_context_for_code_connect Adds: library asset discovery, exact component property definitions. ``` The calling workflow determines the level. When in doubt, start at Level 1 and escalate if data is sparse. ## use_figma Safety Boundary Level 2-3 use `use_figma` for **read-only extraction scripts only**. Scripts from `scripts/` are pre-built for this purpose. Rules: - Scripts MUST NOT create, modify, or delete any nodes, variables, or styles - Every script ends with `return { ... }` containing extracted data - If `use_figma` is unavailable → graceful fallback to Level 1 - Pass `skillNam...