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
npx skills add AceDataCloud/Skills --skill figma -a claude-codeWhat 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/KEYand build the screen - Render node
1:23to 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-code2Manually: put the files in place
~/.claude/skills/figma/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/figma/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill figma -a codex2Manually: put the files in place
.agents/skills/figma/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill figma -a cursor2Manually: put the files in place
.cursor/skills/figma/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/figma2Manually: put the files in place
.github/skills/figma/SKILL.md1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill figma -a gemini-cli2Platform CLI
gemini skills install https://github.com/AceDataCloud/Skills --path skills/figmaManually: put the files in place
.devin/skills/figma/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill figma -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.