Skip to main content
skill CX Codex

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

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

What 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-code

2Manually: put the files in place

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

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

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.

Similar skills

All skills for Design →

From the same set9

figma-generate-design The figma-generate-design Claude Code skill builds composed Figma screens from code or a description. It activates for requests to create or revise a page, form, panel, or other UI view. CX Codex +1 6,600installs figma-create-new-file figma-create-new-file — a skill that tells the agent how to create a Figma Design, FigJam or Slides file with the MCP create_new_file tool, including which plan and editor type to use. CX Codex +1 3,800installs figma-use-motion figma-use-motion — a skill for Claude Code that adds animation context to the use_figma tool. Use it when working with keyframes, timelines, and motion styles in Figma. CX Codex +1 1,600installs figma-shaders The figma-shaders skill for Claude Code, Codex, and Cursor creates, updates, or debugs shader effects and fills in Figma. CX Codex +1 779installs figma-generative-plugins The figma-generative-plugins Claude Code skill guides agents through building and revising generative Figma plugins. It activates for requests to create, fix, or extend one. CX Codex +1 747installs figma-code-workflows figma-code-workflows imports local HTML and running web apps into Figma as editable design frames or runnable code layers. CX Codex +1 432installs Figma MCP Server Connects Figma design context, variables, and components directly to AI coding agents to generate code and update canvas elements. CX Codex +1 ★ 2,221repo stars figma figma connects design files to AI agents to read layout data, variables, and components. Turns selected frames into code and syncs your repository using Code Connect. ★ 2,221repo stars

Project sponsors

Companies that keep this analytics open