Skip to main content
skill CX Codex

figma · acedatacloud — Claude Code skill: what it does, how to install

Skill for Claude Code and other IDEs that reads Figma files via REST API: document tree, individual nodes, PNG rendering and comments. Fires when you turn a design into code.

Apache-2.0 175 installs ★ 17 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill figma -a claude-code
Open on GitHub

What figma does

Runs on six platforms: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. The skill talks to the Figma REST API through curl and jq, reading the OAuth bearer token from $FIGMA_TOKEN. Every request goes to https://api.figma.com/v1 with an Authorization: Bearer $FIGMA_TOKEN header. Read-only, the file stays untouched.

You can fetch the document tree with a depth= limit, pull specific nodes by id, render them to PNG or SVG, and read comments. For design-to-code work the skill renders a frame to an image and reads the node JSON at the same time — colors, spacing, typography.

Figma URLs write node ids with a dash like 1-23, but the API takes a colon: 1:23. Image URLs from /images are temporary. Without $FIGMA_TOKEN set, nothing runs; 403 tells you the token is missing the scope or the file isn't shared with you.

What it helps with

  • Fetch a Figma document tree with a depth limit
  • Render a node to PNG or SVG
  • Extract colors, spacing and fonts from a frame
  • Collect comments on a design file

Example prompts for the agent

  • Read the design at figma.com/design/KEY and build the screen
  • Render node 1:23 to PNG and show it to me
  • Extract colors and spacing from frame 1:45

How to install figma

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill figma -a claude-code

2Manually: put the files in place

~/.claude/skills/figma/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/figma/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about figma

How to install figma in Claude Code?

Run npx skills add AceDataCloud/Skills --skill figma -a claude-code. The skill file lands at ~/.claude/skills/figma/SKILL.md.

What does the figma skill do?

Reads Figma files through the REST API: document tree, individual nodes, PNG/SVG rendering and comments. Read-only, it does not modify the file.

What does the skill need to work?

The $FIGMA_TOKEN environment variable with a Figma OAuth token. Without it every request fails; 403 also means the file isn't shared or the token is missing the scope.

Source text

SKILL.md · Apache-2.0
---
name: figma
description: Read Figma design files, nodes, rendered images and comments via the Figma REST API. Use when the user mentions Figma, a figma.com file link, implementing a design as code, extracting design tokens / colors / spacing, or summarizing comments on a design.
when_to_use: |
  Trigger when the user shares a Figma file URL or wants to read a
  design — get the document tree / a specific frame, render a node to
  PNG/SVG to "see" it, extract styles / tokens, or read comments.
  Read-only. The file key comes from the Figma URL the user pastes.
connections: [figma]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

Read **Figma** via `curl + jq`. The user's OAuth bearer token is in
`$FIGMA_TOKEN`; every call needs `Authorization: Bearer $FIGMA_TOKEN`. Base URL:
`https://api.figma.com/v1`.

Failures are `{"status":<code>,"err":"..."}` — show `err` verbatim. `403` means
the token lacks the scope or the file isn't shared with the user. `404` = bad
file key.

The **file key** is the `figma.com/file/<KEY>/...` or `figma.com/design/<KEY>/...`
segment of a pasted URL. A **node id** is in `?node-id=1-23` (Figma shows `1:23`;
the API also accepts `1:23`).

```bash
F="https://api.figma.com/v1"; AUTH="Authorization: Bearer $FIGMA_TOKEN"
# Who am I (account card)
curl -sS -H "$AUTH" "$F/me" | jq '{handle, email}'
# File document tree (name + top-level frames). Big files: prefer /nodes below.
curl -sS -H "$AUTH" "$F/files/FILE_KEY?depth=2" \
  | jq '{name, pages: [.document.children[] | {name, frames: [.children[]?.name]}]}'
```

## Read specific nodes & render images

```bash
KEY="FILE_KEY"
# Just the nodes you care about (faster than the whole file)
curl -sS -H "$AUTH" "$F/files/$KEY/nodes?ids=1:23,1:45" \
  | jq '.nodes | to_entries[] | {id: .key, name: .value.document.name, type: .value.document.type}'

# Render nodes to images — returns temporary CDN URLs (this is the "see it" tool)
curl -sS -H "$AUTH" "$F/images/$KEY?ids=1:23&format=png&scale=2" \
  | jq '.images'   # { "1:23": "https://...png" }
```

For design-to-code, render the frame to PNG (to view) and read its node JSON
(layout/fills/typography) to extract exact colors, spacing and text.

## Comments & projects

```bash
curl -sS -H "$AUTH" "$F/files/FILE_KEY/comments" \
  | jq '.comments[] | {user: .user.handle, at: .created_at, message}'
# Team projects → files (needs a team id from the Figma URL /team/<id>/...)
curl -sS -H "$AUTH" "$F/teams/TEAM_ID/projects" | jq '.projects'
```

## Gotchas

- Node ids: Figma URLs use `1-23` (dash); the API wants `1:23` (colon). Convert.
- `/images` URLs are **temporary** — download/use them promptly, don't store.
- `depth=` limits tree traversal; omit it only for small files or you'll pull
  megabytes of node JSON.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Similar skills

All skills for Design →

figma by other authors comes first.

figma heygen-com Pulls Figma designs into HyperFrames videos: assets, brand tokens, components, shaders and motion. Imports freeze at build time, renders never call Figma. CX Codex +1 466,500installs figma openai This skill wires Claude to the Figma MCP server: it pulls node context, a screenshot and assets, then turns the frame into code that matches your project. CX Codex +1 858installs figma coco-research Imports Figma assets, brand tokens, and components into HyperFrames compositions, freezing media locally for deterministic rendering. CX Codex +1 ★ 328repo stars Figma Developer daffy0208 Figma Developer is a Claude Code skill that turns Figma designs into React components and CSS tokens. It runs when moving a design system into a codebase. CX Codex +1 152installs understand-figma Egonex-AI understand-figma analyzes a Figma file via the Figma REST API and generates an interactive design knowledge graph with components, screens, and tokens for the dashboard. CX Codex +1 2,400installs figma-developer oakoss figma-developer pulls colours, type styles and icons out of Figma over the REST API and turns them into CSS variables and React components. Useful when the design file moves faster than your code. CX Codex +1 114installs Figma MCP Server planetabhi Local MCP server providing Figma REST API access inside your AI editor. Inspect node trees, retrieve design tokens, and fetch rendered frames. CX Codex +1 ★ 11repo stars figma-official-skills podo figma-official-skills is a Claude Code skill package that moves Figma designs into code, builds design-system libraries and links Figma components to repository components. CX Codex +1 271installs figma-design-to-code official Figma figma-design-to-code is a Codex skill that turns Figma designs into project code. It runs for design implementation requests and calls get_design_context before code is written. CX Codex GP ChatGPT +1 30installs

From the same set67

The whole set →

Project sponsors

Companies that keep this analytics open