Figma use_figma Plugin API Rules
warpdotdev/warp
Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.
REQUIRED reading before using figmaexecute. An agent skill from youware-labs/figma-pilot.
Install Figma Pilot
$ npx skills add youware-labs/figma-pilot --skill figma-pilot -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install youware-labs/figma-pilot figma-pilot --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/youware-labs/figma-pilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills .claude/skills/figma-pilot && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "figma-pilot" agent skill from https://github.com/youware-labs/figma-pilot/tree/master/skills into .claude/skills/figma-pilot/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "figma-pilot", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/youware-labs/figma-pilot/tree/master/skillsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add youware-labs/figma-pilot --skill figma-pilot -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install youware-labs/figma-pilot figma-pilot --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/youware-labs/figma-pilot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills .agents/skills/figma-pilot && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "figma-pilot" agent skill from https://github.com/youware-labs/figma-pilot/tree/master/skills into .agents/skills/figma-pilot/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "figma-pilot", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add youware-labs/figma-pilot --skill figma-pilot -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install youware-labs/figma-pilot figma-pilot --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/youware-labs/figma-pilot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills .cursor/skills/figma-pilot && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "figma-pilot" agent skill from https://github.com/youware-labs/figma-pilot/tree/master/skills into .cursor/skills/figma-pilot/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "figma-pilot", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/youware-labs/figma-pilot.git --path skills--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add youware-labs/figma-pilot --skill figma-pilot -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install youware-labs/figma-pilot figma-pilot --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/youware-labs/figma-pilot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills .gemini/skills/figma-pilot && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "figma-pilot" agent skill from https://github.com/youware-labs/figma-pilot/tree/master/skills into .gemini/skills/figma-pilot/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "figma-pilot", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install youware-labs/figma-pilot figma-pilotInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add youware-labs/figma-pilot --skill figma-pilot -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/youware-labs/figma-pilot.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills .github/skills/figma-pilot && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "figma-pilot" agent skill from https://github.com/youware-labs/figma-pilot/tree/master/skills into .github/skills/figma-pilot/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "figma-pilot", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add youware-labs/figma-pilot --skill figma-pilot -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install youware-labs/figma-pilot figma-pilot --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/youware-labs/figma-pilot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills .opencode/skills/figma-pilot && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "figma-pilot" agent skill from https://github.com/youware-labs/figma-pilot/tree/master/skills into .opencode/skills/figma-pilot/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "figma-pilot", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
figma-pilot- GitHub stars
- 106
- Token cost
- ~978 tokens
- SKILL.md length
- 295 words
- Files
- 22
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- MIT
At a glance
REQUIRED reading before using figmaexecute. An agent skill from youware-labs/figma-pilot.
- Frontend & Design work in your project
- SKILL.md covers When to use, Code Execution Mode and API Reference
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Figma Pilot is an agent skill from youware-labs/figma-pilot. REQUIRED reading before using figmaexecute. Contains API syntax, parameter formats, and examples. READ rules/.md files for correct usage.
Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files (for example `rules/accessibility.md`, `rules/components.md` and `rules/constraints.md`).
It sits in Frontend & Design. It works with Figma and Model Context Protocol. The repository describes itself as: MCP that let AI agents control Figma through code execution. The licence is MIT.
When your agent uses it
- Frontend & Design work in your project
Example prompts
- “/figma-pilot”
What it can do on your machine
Read from SKILL.md and the folder at commit 0aa745d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Figma Pilot loads about 978 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 295 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from youware-labs/figma-pilot at commit 0aa745d, republished under its MIT licence (© youware-labs). 295 words, ~978 tokens.
Download SKILL.mdSave it as
.claude/skills/figma-pilot/SKILL.md (or your agent's skills folder). This skill also uses 21 other files; get the full folder from GitHub.- name
- figma-pilot
- description
- REQUIRED reading before using figma_execute. Contains API syntax, parameter formats, and examples. READ rules/*.md files for correct usage.
- metadata.tags
- figma, mcp, design, ai, components, accessibility, tokens
When to use
ALWAYS read this skill BEFORE calling figma_execute! This skill contains the correct API syntax, parameter formats, and examples that you MUST follow. Failure to read this will result in syntax errors.
Use this skill whenever you are working with figma-pilot MCP tools to create or modify Figma designs.
Code Execution Mode
figma-pilot uses a code execution mode for maximum efficiency. Instead of 15+ individual tools, you use figma_execute to run JavaScript code with access to all Figma APIs.
Available Tools
| Tool | Description |
|---|---|
figma_status | Check connection to Figma plugin (call first) |
figma_execute | Execute JavaScript with all Figma APIs |
figma_get_api_docs | Get detailed API documentation |
Quick Example
// figma_execute
// Create a card and modify selection
await figma.create({
type: 'card',
name: 'Welcome Card',
children: [
{ type: 'text', content: 'Hello!', fontSize: 24 }
]
});
const { nodes } = await figma.query({ target: 'selection' });
for (const node of nodes) {
await figma.modify({ target: node.id, fill: '#0066FF' });
}
console.log(`Modified ${nodes.length} elements`);Benefits
- 90%+ fewer tokens - 3 tools instead of 15+
- Batch operations - Modify many elements in one call
- Data filtering - Filter results before returning to context
- Complex workflows - Loops, conditionals, error handling
API Reference
Read individual rule files for detailed API documentation:
Getting Started
- rules/quick-start.md - Quick start guide and setup requirements
- rules/workflow.md - Recommended agent workflow and operator rules
Core APIs
- rules/status.md -
figma.status()- Check connection - rules/query.md -
figma.query()- Query elements by ID, name, or selection
Creating Elements
- rules/create.md -
figma.create()- Create elements (frames, text, shapes, semantic types) - rules/layout.md - Auto-layout configuration and patterns
Modifying Elements
- rules/modify.md -
figma.modify(),figma.delete(),figma.append()
Styling
- rules/effects.md - Shadows, blur, and visual effects
- rules/gradients.md - Gradient fills (linear, radial, angular)
- rules/corner-radius.md - Independent corner radius
- rules/strokes.md - Stroke styling (dash patterns, caps, alignment)
- rules/transforms.md - Rotation and blend modes
- rules/constraints.md - Responsive constraints and min/max sizes
Text
- rules/text.md - Text elements, wrapping, and sizing
- rules/fonts.md - Loading and using custom fonts
Components
- rules/components.md -
figma.listComponents(),figma.instantiate(),figma.toComponent(),figma.createVariants()
Accessibility
- rules/accessibility.md -
figma.accessibility()- WCAG compliance checking and auto-fixing
Design Tokens
- rules/tokens.md -
figma.createToken(),figma.bindToken(),figma.syncTokens()
Export
- rules/export.md -
figma.export()- Export as PNG, SVG, PDF, JPG
Common Patterns
- rules/patterns.md - Cards, navigation bars, page layouts
Reference
- rules/target-specifiers.md - How to target elements (ID, selection, name)
© youware-labs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 21 other files in skills of youware-labs/figma-pilot.
- SKILL.md
- rules/accessibility.md
- rules/components.md
- rules/constraints.md
- rules/corner-radius.md
- rules/create.md
- rules/effects.md
- rules/export.md
- rules/fonts.md
- rules/gradients.md
- rules/layout.md
- rules/modify.md
- rules/patterns.md
- rules/query.md
- rules/quick-start.md
- rules/status.md
- rules/strokes.md
- rules/target-specifiers.md
- rules/text.md
- rules/tokens.md
- … and 2 more
Open the folder on GitHubat commit 0aa745d
Compare with similar skills
Figma Pilot next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Figma Pilot this skillyouware-labs/figma-pilot | 106 | — | ~978 | Automated safety check: Pass | MIT | |
| Figma use_figma Plugin API Ruleswarpdotdev/warp | 65k | 4 repos | ~4.4k | Automated safety check: Pass | AGPL-3.0 | |
| Figma Design to Codewarpdotdev/warp | 65k | 4 repos | ~2.9k | Automated safety check: Pass | AGPL-3.0 | |
| Figma Code Connect Componentswarpdotdev/warp | 65k | 2 repos | ~4.2k | Automated safety check: Pass | AGPL-3.0 | |
| Figma Screen Generatorwarpdotdev/warp | 65k | 2 repos | ~5k | Automated safety check: Pass | AGPL-3.0 | |
| Refero Designreferodesign/refero_skill | 297 | — | ~5.3k | Automated safety check: Pass | MIT |
Similar skills
Figma Design to Code
warpdotdev/warp
Turns a Figma frame or component into production code that matches the design, using the Figma MCP server and the project's own design system.
Figma Code Connect Components
warpdotdev/warp
Maps published Figma components to their code implementations with Code Connect, using the Figma MCP suggestion and mapping tools.
Figma Screen Generator
warpdotdev/warp
Builds or updates full Figma screens from code or a description by reusing the file's published design system components, variables and styles.
Refero Design
referodesign/refero_skill
Primary/default skill for UI design, product design, web design, landing pages, dashboards, product screens, redesigns, visual polish, frontend/CSS styling, design systems, components, responsive…
- Official
Build Figma
cursor/plugins
Guides an agent through turning a Figma node into production UI with the repo's own components, then checks the result visually before finishing.
Related
Works with
Categories
Questions about Figma Pilot
What does Figma Pilot do?
REQUIRED reading before using figmaexecute. An agent skill from youware-labs/figma-pilot. Figma Pilot is an agent skill from youware-labs/figma-pilot. REQUIRED reading before using figmaexecute.
When should I use Figma Pilot?
Figma Pilot fits situations like: frontend & Design work in your project.
How do I install Figma Pilot in Claude Code?
Run `npx skills add youware-labs/figma-pilot --skill figma-pilot -a claude-code`. Or copy the skill folder (skills in youware-labs/figma-pilot) into .claude/skills/figma-pilot in your project. Claude Code loads it when a task matches its description.
How do I install Figma Pilot in Codex?
Run `npx skills add youware-labs/figma-pilot --skill figma-pilot -a codex`. Or copy the skill folder (skills in youware-labs/figma-pilot) into .agents/skills/figma-pilot in your project. Codex loads it when a task matches its description.
Can I use Figma Pilot in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add youware-labs/figma-pilot --skill figma-pilot -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/figma-pilot, .gemini/skills/figma-pilot, .github/skills/figma-pilot and .opencode/skills/figma-pilot in your project.
What does Figma Pilot need to run?
SKILL.md names no scripts, command-line tools or credentials: Figma Pilot is instructions for the agent only.
Does Figma Pilot access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Figma Pilot safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Figma Pilot use?
Figma Pilot is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Figma Pilot use?
About 978 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Figma Pilot?
Skills that share tags, products or a category with Figma Pilot: Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars), Figma Design to Code (warpdotdev/warp, 65k stars), Figma Code Connect Components (warpdotdev/warp, 65k stars) and Figma Screen Generator (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Figma Pilot?
youware-labs (a GitHub organization) maintains it in youware-labs/figma-pilot, which has 106 GitHub stars. The repository was last updated on January 29, 2026.
Source: youware-labs/figma-pilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.