Figma cli

Skill wohsj110/figma_cli/skills/figma-cli

Agent-friendly Figma REST API CLI: reproducible reads of files/nodes, asset export, comments and design metadata — with a bundled agent skill for Claude Code / Codex / Cursor.

Install

npx -y skills add wohsj110/figma_cli --skill figma-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

21 days oldThe repository was created 21 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when reading Figma files or nodes, exporting node images or assets, listing Figma comments, components, styles, or variables through the figma-cli command line, or setting up Figma token credentials. Token-based reads work headlessly — no Figma app or browser required.

SKILL.md

2.7 KB, as published. Nobody here has run it

Figma CLI Skill

Use this skill when an agent needs stable, reproducible reads from the Figma REST API through figma-cli.

CLI Setup

Before using Figma commands, check whether figma-cli is available with command -v figma-cli.
If missing, install with brew install --cask wohsj110/tap/figma-cli; without Homebrew, go install github.com/wohsj110/figma_cli/cmd/figma-cli@latest (requires Go ≥ 1.26).

Credential Setup

Verify access first: figma-cli me. If it prints the current Figma user, credentials are ready.
If not configured, ask the user for a Figma personal access token, then store it in the OS keyring:

printf %s "$FIGMA_TOKEN" | figma-cli init --token-stdin

For CI or one-off runs, FIGMA_TOKEN env takes precedence over the keyring.
Never print, log, or hardcode token values. The CLI never prints the token; keep it that way in your own output too.

Core Rules

Paste full Figma URLs directly — file keys and node ids resolve automatically. Never guess a node id; if you don't have one, ask the user or list metadata first.
Default output is concise text. Add --raw only when the original API JSON is genuinely needed.
GET responses are cached for 15 minutes. Use --no-cache when freshness matters, --cache-ttl 1h to extend.
Request large files deliberately: start with --depth 2 before any deep dump.
--verbose prints request diagnostics without token values — use it when debugging API errors.

Commands

figma-cli me                                                        # current user / credential check
figma-cli file get "https://www.figma.com/design/KEY/name?node-id=1-2"
figma-cli file get FILE_KEY --depth 2                               # bounded file summary
figma-cli node inspect FILE_KEY --node 1:2 [--raw]                  # node summary / raw API JSON
figma-cli image export FILE_KEY --node 1:2 --format png --scale 2   # export image URL
figma-cli image export FILE_KEY --node 1:2 --format png --out ./dir # download asset locally
figma-cli comments list FILE_KEY                                    # review context
figma-cli components list FILE_KEY
figma-cli styles list FILE_KEY
figma-cli variables list FILE_KEY                                   # design tokens

Boundaries

This CLI is read-only inspection and asset export by design — it never writes back to Figma.

Gives 0 of the 12 instructions most images graphics skills give

Counted across 371 of the 372 authors here whose files we hold, read 2026-08-06

create a complete brand world in one imagein 19 of 371, across 5 files
infer the brand strategy before generatingin 19 of 371, across 5 files
use a clean presentation gridin 19 of 371, across 5 files
confirm connection status is activein 19 of 371, across 4 files
base the visual system on meaningin 17 of 371, across 3 files
use very little textin 17 of 371, across 3 files
make every panel feel connectedin 17 of 371, across 3 files
call RUBE_SEARCH_TOOLS firstin 17 of 371, across 3 files
convert dash-format node IDs to colon formatin 17 of 371, across 5 files
match reference quality and rhythm if providedin 16 of 371, across 2 files
narrow scope or reduce depth to avoid oversized payloadsin 16 of 371, across 4 files
generate a simple and memorable logoin 15 of 371, across 1 file

Said here and by no other author read

check figma-cli availability before use
install figma-cli if missing
store token in OS keyring
paste full Figma URLs directly
never guess a node id
use --depth 2 for large files

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once.