kata-mcp-figma-extract

Extract Figma design tokens and component specifications into JSON and Markdown.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-mcp-figma-extract
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-mcp-figma-extract
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-mcp-figma-extract
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-mcp-figma-extract

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of manually translating a Figma design into implementation-ready artifacts, like design tokens and component specifications, that developers can actually use.

Core Features & Use Cases

  • Token extraction from Figma variables: Converts Figma local variables (colors, spacing, typography-related values) into a structured JSON tokens file.
  • Component specification documentation: Collects component metadata (names, descriptions, dimensions, variants/properties, applied styles) and renders it into a human-readable Markdown spec.
  • MCP-driven, safe read-only workflow: Uses MCP tools and requires environment-based authentication to avoid direct REST calls and protect credentials.

Quick Start

Run kata-mcp-figma-extract with your Figma File ID to extract design tokens and component specs into docs/design/.

Frequently Asked Questions about kata-mcp-figma-extract

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

FAQPage Schema
How do I extract design tokens from a Figma file for design-to-code handoff?

To extract design tokens from a Figma file, you need a workflow that retrieves local variables like colors, spacing, and typography, then converts them into a structured JSON file. This process applies MCP tools for read-only retrieval to generate implementation-ready artifacts automatically.

Can I generate component specifications in Markdown from Figma components?

Yes, you can generate component specifications in Markdown by collecting component metadata such as names, descriptions, dimensions, variants, and applied styles. This documentation renders human-readable specs directly from the Figma file to streamline developer handoff.

Do I need an API key to extract color and spacing tokens from Figma?

Yes, you need a FIGMA_API_KEY for environment-based authentication to extract color and spacing tokens. This read-only MCP workflow requires valid credentials to safely retrieve variables and components without direct REST calls, protecting your credentials.

What is the best way to automate Figma UI handoff to generate token JSON and spec Markdown?

The best way to automate Figma UI handoff is using an MCP-driven workflow that deterministically extracts design tokens and component specs into fixed output paths. This approach avoids manual translation and ensures consistent JSON and Markdown files for developers.

Does extracting Figma variables with an MCP server overwrite existing destination files?

Extracting Figma variables with an MCP server uses guarded overwriting to protect existing destination files. The workflow targets deterministic output paths like docs/design/ and applies safe, read-only operations to prevent accidental data loss during token extraction.

Are there limitations when using MCP tools to retrieve Figma component specs?

Limitations when using MCP tools to retrieve Figma component specs include requiring read-only access and strict environment-based authentication. The workflow depends on MCP variables and components retrieval tools, meaning it cannot execute direct REST calls or modify the original Figma file.