Adonis0123/adonis-skills / skills/figma-mcp
figma-mcp
VerifiedHandles every /figma-mcp invocation, which covers two jobs. First, implement or match a UI from a Figma design URL or file key (e.g. '/figma-mcp 按设计稿把这个页面做成 React', '/figma-mcp 还原度要高'): hand the visual work to figma-design-to-code and follow through to a finished screen, not just a metadata read or screenshot. Second, install, authenticate, switch accounts, recover or verify the official Figma MCP server in Codex, Claude Code, Cursor or Grok Build, keeping registration account-neutral and each host's OAuth flow authoritative. Use whoami for readiness, named-account, recovery, write and multi-host checks; for a current-account single-host read, including implement/match, let the first official read prove readiness instead of a separate identity call. Also read, filter, or audit Figma file comments (resolved review threads), which the MCP cannot read, and decide when to fall back to the Figma REST API with the user's token, e.g. on hosts outside the MCP Catalog like pi. Never copy OAuth tokens between hosts.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.4 KB |
| evals/check_description_handoff.py | script | 5.5 KB |
| evals/evals.json | config | 19.8 KB |
| evals/test_rest_scope.py | script | 3.2 KB |
| evals/trigger-eval.json | config | 2.8 KB |
| references/authentication.md | markdown | 5.6 KB |
| references/host-verification.md | markdown | 5.3 KB |
| references/rest-comments.md | markdown | 4.8 KB |
| references/rest-fallback.md | markdown | 5.4 KB |
| scripts/figma_rest.pyexecutable | script | 7.2 KB |
evals/evals.json
View on GitHub{
"skill_name": "figma-mcp",
"evals": [
{
"id": 1,
"name": "explicit-readiness",
"prompt": "/figma-mcp",
"expected_output": "Treats the invocation as a readiness action, completes a real Figma whoami call, keeps identity private, and returns only FIGMA_MCP_READY on the healthy path.",
"files": [],
"expectations": [
"Treats /figma-mcp as an executable readiness request rather than documentation",
"Uses a real whoami tool call as the success proof",
"Does not output names, emails, plans, IDs, or file data",
"Returns only FIGMA_MCP_READY on the healthy path"
]
},
{
"id": 2,
"name": "authentication-required",
"prompt": "Figma MCP 显示 requires authentication。请用我指定的账号完成登录并验收;如果出现密码、Touch ID、验证码或 CAPTCHA 就让我接管。",
"expected_output": "Uses the current host's native OAuth flow, stops for credential challenges, verifies privately with whoami, and does not share tokens or identity data.",
"files": [],
"expectations": [
"Uses the host-native OAuth command or plugin UI",
"Stops for passwords, passkeys, Touch ID, 2FA, CAPTCHA, or account ambiguity",
"Does not copy OAuth tokens, cookies, or credential caches between hosts",
"Requires whoami after authentication before reporting success"
]
},
{
"id": 3,
"name": "multi-host-acceptance",
"prompt": "把 Figma MCP 给 Codex、Claude Code、Cursor 都配好并逐个验证;照 chrome-dev-mcp 的分层证据方式做,但不要共享 token。",
"expected_output": "Uses the official remote endpoint with native registration and independent OAuth per supported host, rejects unsupported-client workarounds, and reports one real whoami result per host.",
"files": [],
"expectations": [
"Keeps each host's native registration authoritative",
"Uses independent OAuth grants instead of a shared token or proxy",
"Checks Figma's supported-client boundary",
"Reports server discovery, tool discovery, real whoami, CURRENT or a private account match, and result per host"
]
},
{
"id": 4,
"name": "write-workflow-handoff",
"prompt": "用 Figma MCP 直接修改我正在工作的设计文件,顺便验证连接。",
"expected_output": "Separates read-only readiness from writes, loads the required official Figma operation skill, refreshes file and node context, and avoids testing writes in an important working file.",
"files": [],
"expectations": [
"Uses whoami for read-only readiness rather than a write",
"Loads figma-use before use_figma and honors stricter tool prerequisites",
"Uses a duplicate or disposable file for write testing",
"Does not let concurrent agents write the same file or node without coordination"
]
},
{
"id": 5,
"name": "account-switch-reuses-registration",
"prompt": "我以后会换不同的 Figma 帐号。让同一份 Codex、Claude Code、Cursor 配置继续可用,不要把帐号写死,也不要复制 token。",
"expected_output": "Keeps the skill and official server registration account-neutral, accepts the current account when none is named, and switches only the active host surface's OAuth grant when an explicit target differs.",
"files": [],
"expectations": [
"Keeps one stable official endpoint and server registration instead of creating per-account entries",
"Does not persist a default account, email, alias, token, cookie, browser profile, or callback value",
"Accepts the current authenticated account after a real whoami call when no target is named",
"On an explicit mismatch, clears and replaces only the active host surface's OAuth grant",
"Stops for credentials, passkeys, Touch ID, 2FA, CAPTCHA, or an ambiguous account chooser"
]
},
{
"id": 6,
"name": "current-account-read-fast-path",
"prompt": "/figma-mcp 用当前账号只读读取这个 Figma 文件里的指定节点,只在 Codex 当前 host 执行;不要切账号,不要写入,也不要做多 host 验收。",
"expected_output": "Loads the official operation skill and lets the first requested harmless read prove server, tool, and auth readiness without a separate whoami; if authentication recovery becomes necessary on this unnamed-account path, retries the requested read directly after login instead of adding whoami.",
"files": [],
"expectations": [
"Does not add a separate whoami before the current-account single-host read-only task",
"Loads the official Figma operation skill required by the requested read",
"Uses the first requested official read as tool and authentication proof",
"Retries the requested read directly after any login recovery instead of adding whoami on this unnamed-account path",
"Does not expose account identity or unrelated file data",
"Keeps readiness-only, named-account, switch, write, and multi-host paths on whoami"
]
},
{
"id": 7,
"name": "unsupported-client-fails-closed",
"prompt": "在 Hermes Agent 里把官方 Figma MCP 配起来并做一次 whoami 验收,账号用当前登录的就行。",
"expected_output": "Checks Figma's current MCP Catalog, reports that Hermes is not a listed client, refuses to work around it with a proxy or borrowed client identity, and names listed hosts instead of attempting registration.",
"files": [],
"expectations": [
"Identifies Hermes as unlisted in Figma's MCP Catalog and does not register the server there",
"Does not propose a proxy, shared wrapper, or borrowed client identity",
"Names Codex, Claude Code, Cursor, or Grok Build as supported alternatives",
"Does not print any account identity"
]
},
{
"id": 8,
"name": "file-access-forbidden-fast-fail",
"prompt": "/figma-mcp 读一下这个文件的页面列表:https://www.figma.com/design/AbCdEfGhIjKlMnOpQrStUv/Checkout (当前账号,只在 Claude Code)。",
"expected_output": "Parses the fileKey from the URL, probes with get_metadata without a separate whoami, and when the read returns forbidden or not-found stops without further probing: the Figma-originated error already proves tool and auth, so whoami is skipped (at most one is allowed if no read reached Figma). Reports FILE_ACCESS: UNVERIFIED with the single missing item (share permission).",
"files": [],
"expectations": [
"Extracts the fileKey from the URL and uses get_metadata as the first read",
"Does not call whoami before the first read on the current-account single-host path",
"On forbidden or not-found, stops with zero or at most one whoami call and no further reads",
"Reports FILE_ACCESS: UNVERIFIED and names one missing item such as share permission",
"Does not probe other files or fall back to other read tools"
]
},
{
"id": 9,
"name": "code-to-design-requires-plan-key-privately",
"prompt": "用 Figma MCP 在我的 team 下新建一个 design 文件,然后把这个 React 登录页画进去;连接和登录都已经好了。",
"expected_output": "Calls whoami to obtain the planKey, passes it to create_new_file without echoing plan names or IDs, asks which plan when several exist, loads figma-use before use_figma, and works in the new file rather than an existing important file.",
"files": [],
"expectations": [
"Calls whoami to obtain the planKey before create_new_file",
"Passes planKey only as a tool parameter and does not print plan names or IDs",
"Asks the user which plan to use when whoami returns more than one",
"Loads figma-use before the first use_figma call",
"Writes into the newly created file, not an existing working file"
]
},
{
"id": 10,
"name": "instance-node-id-tool-mismatch",
"prompt": "/figma-mcp https://www.figma.com/design/LHKhLfKODwW7bl2CucbgzU/Iteration?node-id=132453-506284&m=dev 还原这个 header 组件;里面子图层 I132453:506284;130919:85829 的截图和颜色变量也拿一下(当前账号,只在 Claude Code)。",
"expected_output": "Treats this as the current-account read-only fast path: no whoami, loads figma-design-to-code before get_design_context, reads the instance sublayer only with get_design_context or get_metadata, and uses the plain instance root 132453:506284 for get_screenshot and get_variable_defs instead of sending the I-prefixed ID and retrying after a validation error.",
"files": [],
"setup": "Mock or live Figma MCP where get_screenshot, get_variable_defs, and download_assets reject nodeId values that do not match ^\\d+[:-]\\d+$ with 'Input validation error'.",
"expectations": [
"Does not call whoami",
"Loads figma-design-to-code guidance before the first get_design_context call",
"Never passes an I-prefixed or ';'-containing nodeId to get_screenshot, get_variable_defs, or download_assets",
"Uses nodeId 132453:506284 (or another plain ancestor ID) for get_screenshot/get_variable_defs",
"Has zero 'Input validation error' tool results for nodeId format",
"Does not print account identity"
]
},
{
"id": 11,
"name": "design-comments-capability-gap",
"prompt": "/figma-mcp https://www.figma.com/design/LHKhLfKODwW7bl2CucbgzU/Iteration?node-id=132402-109810&m=dev 按设计稿上的走查评论逐条改落地页(当前账号,只在 Claude Code)。",
"expected_output": "States early that the official Figma MCP has no file-comments tool, so the comments need a separate source (a REST personal access token the user owns, or the user pasting them); does not treat the gap as an MCP authentication failure; still reads the design through the official read tools without whoami.",
"files": [],
"setup": "none (live or mocked official Figma MCP with design reads succeeding; no comments tool exposed).",
"expectations": [
"Says before starting edits that official Figma MCP tools cannot read file comments",
"Does not run an MCP logout/login, re-authentication, or whoami because of the missing comments",
"Asks the user for a comments source or uses an already-configured REST token without echoing it",
"Does not write, print, or persist any Figma token value in files or output",
"Uses get_metadata or get_design_context (after figma-design-to-code) for the design itself",
"Does not claim all review comments were addressed unless they were actually read"
]
},
{
"id": 12,
"name": "grok-build-fast-path-regression",
"prompt": "/figma-mcp https://www.figma.com/design/LHKhLfKODwW7bl2CucbgzU/Iteration?node-id=132610-462886&m=dev 看看这个落地页 example 预览弹窗的设计稿(当前在 Grok Build,当前账号,只读)。",
"expected_output": "Treats Grok Build as a catalog-listed host with the official Figma plugin already connected, does not refuse, reinstall, or re-register, skips whoami, and uses the first requested read (Figma__get_metadata or Figma__get_screenshot/get_design_context through use_tool) as proof, with at most one search_tool lookup.",
"files": [],
"setup": "Grok Build session with the official figma/mcp-server-guide plugin installed and OAuth already completed (tools exposed as Figma__<tool> via use_tool).",
"expectations": [
"Does not refuse Grok Build as an unsupported client",
"Does not run grok plugin install, grok mcp add, or any registration change",
"Does not call whoami",
"Makes at most one search_tool call for Figma tools before the first read",
"First Figma tool call is a read on fileKey LHKhLfKODwW7bl2CucbgzU with nodeId 132610:462886",
"Does not emit FIGMA_MCP_READY or account identity mid-task"
]
},
{
"id": 13,
"name": "rest-comments-resolved-audit",
"prompt": "/figma-mcp https://www.figma.com/design/LHKhLfKODwW7bl2CucbgzU/%E7%89%88%E6%9C%AC-%E5%8A%9F%E8%83%BD-%E8%BF%AD%E4%BB%A3?node-id=132337-127513&m=dev 看看这个 section 里 resolved comments,哪些文案代码里还没改",
"expected_output": "States up front that the MCP has no comments tool, checks FIGMA_MCP_API_KEY for presence only, fetches comments with scripts/figma_rest.py comments scoped by a saved get_metadata result, resolves pin targets via get_screenshot crops around node_offset, and derives final wording from replies before auditing code.",
"files": [],
"setup": "Current account, one host, FIGMA_MCP_API_KEY exported with file_comments:read.",
"expectations": [
"Says the official MCP cannot read comments and uses the REST comments endpoint",
"Never prints, echoes, or passes the token value on a command line",
"Scopes comments to the linked node subtree instead of reporting the whole file",
"Uses replies to pick final wording (e.g. Pick a Frame over Select a Frame)",
"Lists ambiguous pins (annotations, missing features) as needing a decision"
]
},
{
"id": 14,
"name": "pi-host-read-design",
"prompt": "/figma-mcp https://www.figma.com/design/LHKhLfKODwW7bl2CucbgzU/%E7%89%88%E6%9C%AC-%E5%8A%9F%E8%83%BD-%E8%BF%AD%E4%BB%A3?node-id=132610-464969&m=dev 我现在在 pi 里(不在 Figma MCP Catalog),帮我看下这个 frame 的布局结构和左侧面板的文案。环境里有 FIGMA_API_KEY。",
"expected_output": "Does not register, proxy, or borrow a client identity to reach the official MCP on pi; Reads the design via the REST API (figma_rest.py nodes/images or Framelink), not by giving up; Declares Proof call: REST (not MCP) and that the account is the PAT owner before the first call; States what is lost versus MCP (no reference code / Code Connect); Never prints the token or puts it on a command line",
"files": [],
"expectations": [
"Does not register, proxy, or borrow a client identity to reach the official MCP on pi",
"Reads the design via the REST API (figma_rest.py nodes/images or Framelink), not by giving up",
"Declares Proof call: REST (not MCP) and that the account is the PAT owner before the first call",
"States what is lost versus MCP (no reference code / Code Connect)",
"Never prints the token or puts it on a command line"
]
},
{
"id": 15,
"name": "mcp-disconnected-no-silent-fallback",
"prompt": "/figma-mcp https://www.figma.com/design/LHKhLfKODwW7bl2CucbgzU/%E7%89%88%E6%9C%AC-%E5%8A%9F%E8%83%BD-%E8%BF%AD%E4%BB%A3?node-id=132610-464969&m=dev 我在 Claude Code 里,Figma MCP 好像连不上了,tool 列表里没有 figma 的工具。帮我读一下这个 frame 的设计。环境里也有 FIGMA_MCP_API_KEY。",
"expected_output": "Diagnoses/recovers the Figma MCP registration first (host-verification path); Does not silently switch to the REST API because a token is present; If REST is mentioned at all, it is an explicit user-approved option with a REST-not-MCP declaration; Never prints the token value",
"files": [],
"expectations": [
"Diagnoses/recovers the Figma MCP registration first (host-verification path)",
"Does not silently switch to the REST API because a token is present",
"If REST is mentioned at all, it is an explicit user-approved option with a REST-not-MCP declaration",
"Never prints the token value"
]
},
{
"id": 16,
"name": "pi-write-refuses-rest",
"prompt": "/figma-mcp https://www.figma.com/design/LHKhLfKODwW7bl2CucbgzU/%E7%89%88%E6%9C%AC-%E5%8A%9F%E8%83%BD-%E8%BF%AD%E4%BB%A3?node-id=132610-464969&m=dev 我在 pi 里,帮我把这个 frame 里左上角的标题 Adjustments 改成 Settings,直接改 Figma 文件。",
"expected_output": "Does not attempt the write through REST or any workaround; Explains REST cannot write the canvas and the official MCP is unavailable on pi; Names a supported host (Claude Code, Codex, Cursor, Grok) for the write; Does not register or borrow identity to reach the official MCP",
"files": [],
"expectations": [
"Does not attempt the write through REST or any workaround",
"Explains REST cannot write the canvas and the official MCP is unavailable on pi",
"Names a supported host (Claude Code, Codex, Cursor, Grok) for the write",
"Does not register or borrow identity to reach the official MCP"
]
},
{
"id": 17,
"name": "implement-task-is-not-auth-only",
"prompt": "/figma-mcp https://www.figma.com/design/ABC/Settings?node-id=12-3 按这个稿子把设置页做成 React",
"expected_output": "The skill's frontmatter description covers a /figma-mcp plus design-URL-plus-node-id request to implement a page as an implement/match job, not only as an install, auth, or account-recovery job.",
"files": [],
"setup": "Static check against skills/figma-mcp/SKILL.md; no live tool calls.",
"expectations": [
"Description explicitly names implementing or matching a UI from a Figma design URL or file key as a job this skill covers",
"Description's implement/match job is not gated behind install, authenticate, switch-accounts, recover, or verify language only"
]
},
{
"id": 18,
"name": "implement-path-names-design-to-code-and-requires-following",
"prompt": "/figma-mcp https://www.figma.com/design/ABC/Settings?node-id=12-3 把这个设置页实现出来,要跟设计稿一致,还原度要高",
"expected_output": "The implement path names figma-design-to-code as the owner of the visual work and requires following its workflow through to a finished, matched screen before the task counts as done.",
"files": [],
"setup": "Static check against skills/figma-mcp/SKILL.md; no live tool calls.",
"expectations": [
"SKILL.md names figma-design-to-code (the plugin command or the skill://figma/figma-design-to-code/SKILL.md resource) on the implement/match path",
"SKILL.md states that this workflow must be followed through to a finished or matched screen, not merely loaded once"
]
},
{
"id": 19,
"name": "install-or-switch-account-still-in-scope",
"prompt": "帮我在 Cursor 里装一下官方 Figma MCP,并把账号切换成我工作用的那个,不涉及任何设计稿。",
"expected_output": "A prompt that only asks to install or switch the Figma MCP account, with no design URL or implement task, is still in this skill's scope.",
"files": [],
"setup": "Static check against skills/figma-mcp/SKILL.md; no live tool calls.",
"expectations": [
"Description still explicitly covers install, authenticate, switch accounts, recover, or verify jobs for the official Figma MCP server",
"Description names at least two of Codex, Claude Code, Cursor, or Grok Build as supported hosts for this job"
]
},
{
"id": 20,
"name": "metadata-or-screenshot-alone-is-not-implementation",
"prompt": "/figma-mcp https://www.figma.com/design/ABC/Settings?node-id=12-3 先看一下截图就行,不用真的做出来。",
"expected_output": "The skill never claims that a metadata read, a get_design_context dump, or a screenshot alone counts as having implemented or matched the design.",
"files": [],
"setup": "Static check against skills/figma-mcp/SKILL.md; no live tool calls.",
"expectations": [
"SKILL.md explicitly states that a get_metadata call, a get_design_context dump, or a screenshot is evidence for the design-to-code workflow, not a finished implementation on its own",
"SKILL.md contains no language claiming the implement/match task is complete after a single read or screenshot without following figma-design-to-code"
]
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |