figma-spec — Claude Code skill: what it does, how to install
Enables coding agents to draft, inspect, edit, and comment on Figma specs formatted as Markdown inside designs or dedicated files.
no license 447 installs ★ 2,221 updated 2026-11-16
npx skills add figma/mcp-server-guide --skill figma-spec -a claude-codeWhat figma-spec does
This skill guides the assistant through the figma.spec JavaScript API to interact with native specification documents. Figma stores these specs as GitHub-Flavored Markdown within SPEC_BLOCK canvas nodes. The workflow covers locating existing spec documents across pages, generating new ones in FigJam or Design boards, and spinning up standalone figspec files.
Content updates rely on editContent rather than rewriting the whole document. Every replacement requires a single exact match for the target text; duplicate or missing matches abort the edit without altering content. Destructive calls to setContent remain restricted to initial blank drafts.
Without an active Figma plan that enables Specs, figma.spec stays undefined, forcing the agent to halt execution immediately.
What it helps with
- draft a PRD or technical RFC directly inside Figma
- apply targeted text updates to an existing design spec
- attach inline comment threads to specific sentences in a spec
- scan canvas pages to locate embedded Markdown document blocks
Example prompts for the agent
- Create an embedded spec on the current canvas outlining user onboarding flow
- Update the authentication section in the Figma spec using exact match replacement
- Add a comment on the performance requirements paragraph in the active spec
How to install figma-spec
1Skills CLI (Vercel)
npx skills add figma/mcp-server-guide --skill figma-spec -a claude-code2Manually: put the files in place
~/.claude/skills/figma-spec/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/figma-spec/
1Skills CLI (Vercel)
npx skills add figma/mcp-server-guide --skill figma-spec -a codex2Manually: put the files in place
.agents/skills/figma-spec/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add figma/mcp-server-guide --skill figma-spec -a cursor2Manually: put the files in place
.cursor/skills/figma-spec/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install figma/mcp-server-guide skills/figma-spec2Manually: put the files in place
.github/skills/figma-spec/SKILL.md1Skills CLI (Vercel)
npx skills add figma/mcp-server-guide --skill figma-spec -a gemini-cli2Platform CLI
gemini skills install https://github.com/figma/mcp-server-guide --path skills/figma-specManually: put the files in place
.devin/skills/figma-spec/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add figma/mcp-server-guide --skill figma-spec -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-spec
How do I install figma-spec in Claude Code?
Run npx skills add figma/mcp-server-guide --skill figma-spec -a claude-code in your terminal. This writes the skill definition to ~/.claude/skills/figma-spec/SKILL.md.
What does the figma-spec skill do?
It provides structured instructions for interacting with Figma and FigJam specification blocks via the figma.spec API using GitHub-Flavored Markdown.
Why would an edit operation fail in figma-spec?
The editContent method strictly enforces a single unique occurrence of the target text string, so ambiguous matches or missing text will throw an error.