Agent skill

Figma Use

by shepherdjerred in shepherdjerred/monorepo

This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma"…

GPL-3.0Auto-check passedFrontend & Design

Install Figma Use

skills CLI
$ npx skills add shepherdjerred/monorepo --skill figma-use -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shepherdjerred/monorepo figma-use --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/figma-use .claude/skills/figma-use && rm -rf skills-src

Use ~/.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/

Facts

Skill name
figma-use
GitHub stars
112
Token cost
~946 tokens
SKILL.md length
250 words
Files
2 (incl. references)
Skills in repo
63
Repo updated
First seen
Licence
GPL-3.0

At a glance

This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma"…

  • Works in 2 steps: Create a 1024x1024 frame with squircle… → Export at required sizes and package…
  • Asks to create a Figma design
  • SKILL.md covers Connection, Quick Reference, Key Rules and macOS App Icon Workflow, plus 2 more sections
  • Calls osascript

What it does

Figma Use is an agent skill from shepherdjerred/monorepo. This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma", "modify Figma design", or mentions Figma design tasks. Controls Figma desktop via CLI with imperative commands and declarative JSX rendering.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/commands.md`).

It sits in Frontend & Design, covering React components. It works with Figma, Model Context Protocol and macOS. The repository describes itself as: Monorepo for all of my projects. The licence is GPL-3.0.

When your agent uses it

  • Asks to create a Figma design
  • Design in Figma
  • Make a Figma mockup
  • Create an app icon

Example prompts

  • “create a Figma design”
  • “design in Figma”
  • “make a Figma mockup”
  • “/figma-use”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Create a 1024x1024 frame with squircle corners (Apple uses cornerSmoothing={0.6})
  2. Export at required sizes and package with macOS tools

What it can do on your machine

Read from SKILL.md and the folder at commit da14ae9. 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

    Shell commands in SKILL.md call:

    • osascript

    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 Use loads about 946 tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 86 tokens; SKILL.md has 250 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~946
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3k

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 shepherdjerred/monorepo at commit da14ae9, republished under its GPL-3.0 licence (© shepherdjerred). 250 words, ~946 tokens.

Download SKILL.mdSave it as .claude/skills/figma-use/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
figma-use
description
This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma", "modify Figma design", or mentions Figma design tasks. Controls Figma desktop via CLI with imperative commands and declarative JSX rendering.

figma-use

CLI tool to control Figma desktop app. Two modes: imperative commands and declarative JSX rendering. Installed at ~/.bun/bin/figma-use.

Connection

Figma must be running with remote debugging enabled.

bash
# Check connection
figma-use me  # More reliable than `figma-use status` (which has a font-loading bug)

# If not connected, quit and relaunch Figma:
osascript -e 'tell application "Figma" to quit'
sleep 2
open -a Figma --args --remote-debugging-port=9222

Figma 126+ blocks the debug port. Run figma-use patch once to fix (click "Always Allow" on the keychain prompt). Re-run after Figma updates.

Alternative: figma-use daemon start --pipe launches Figma with a debug pipe (no patching needed).

Quick Reference

Imperative Commands
bash
figma-use create frame --width 400 --height 300 --fill "#FFF" --layout VERTICAL --gap 16
figma-use create text --text "Hello" --font-size 24 --fill "#000"
figma-use create rect --width 100 --height 50 --fill "#F00" --radius 8
figma-use create icon mdi:home --size 32 --color "#3B82F6"
figma-use set fill <id> "#FF0000"
figma-use node move <id> --x 100 --y 200
figma-use export node <id> --output design.png
figma-use export screenshot --output viewport.png
Declarative JSX

Props go directly on elements, NOT in style={{}}:

bash
echo '<Frame p={24} gap={16} flex="col" bg="#FFF" rounded={12}>
  <Text size={24} weight="bold" color="#000">Title</Text>
  <Text size={14} color="#666">Description</Text>
</Frame>' | figma-use render --stdin --x 100 --y 200

Elements: Frame, Rectangle, Ellipse, Text, Line, Star, Polygon, Vector, Group, Icon, Image, Instance

Icons (150k+ from Iconify)
bash
figma-use create icon lucide:star --size 48 --color "#F59E0B"

In JSX: <Icon name="mdi:home" size={24} color="#3B82F6" />

Key Rules

  • Always use --x and --y to position renders. Never stack at (0, 0).
  • Always verify visually after creating: figma-use export node <id> --output /tmp/check.png
  • Zoom after creating: figma-use viewport zoom-to-fit <id>
  • After initial render, use diffs or direct commands — do not re-render full JSX trees.
  • Row layouts need explicit width: <Frame w={300} flex="row" gap={8}>
  • Prefer human-readable output over --json to save tokens.

macOS App Icon Workflow

To create a macOS app icon in Figma:

  1. Create a 1024x1024 frame with squircle corners (Apple uses cornerSmoothing={0.6}):
bash
echo '<Frame w={1024} h={1024} bg="#3B82F6" rounded={220} cornerSmoothing={0.6}>
  <Frame w={1024} h={1024} flex="col" justify="center" items="center">
    <Icon name="lucide:terminal" size={512} color="#FFFFFF" />
  </Frame>
</Frame>' | figma-use render --stdin --x 0 --y 0
  1. Export at required sizes and package with macOS tools:
bash
figma-use export node <id> --output icon_1024.png --scale 1
# Then use sips + iconutil to create .icns

MCP Server

figma-use includes a built-in MCP server exposing 90+ tools. Already configured in Claude Code at http://localhost:38451/mcp.

Start before use: figma-use mcp serve

Additional Resources

For the complete command reference, style shorthands, components, variants, diffs, queries, analyze, and lint commands, consult:

  • references/commands.md — Full figma-use command reference and style shorthand tables

© shepherdjerred, GPL-3.0. 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 1 other file (references) in packages/dotfiles/dot_agents/skills/figma-use of shepherdjerred/monorepo.

  • SKILL.md
  • references/commands.md

Open the folder on GitHubat commit da14ae9

Compare with similar skills

Figma Use 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.

Figma Use compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Figma Use this skillshepherdjerred/monorepo112—~946Automated safety check: PassGPL-3.0
Wonder BlocksKhan/wonder-blocks163—~3.2kAutomated safety check: PassMIT
Loora Design Guidelassejlv/loora140—~2.4kAutomated safety check: PassAGPL-3.0
Figma Connect Componentbitovi/ai-enablement-prompts121—~3.3kAutomated safety check: PassMIT
Figma Bridge Doctorhashgraph-online/awesome-codex-plugins1.2k—~6.7kAutomated safety check: PassMIT
Figma use_figma Plugin API Ruleswarpdotdev/warp65k4 repos~4.4kAutomated safety check: PassAGPL-3.0

Similar skills

  • Wonder Blocks

    Khan/wonder-blocks

    Implements user interfaces using the Wonder Blocks (WB) design system — Khan Academy's React component library.

    163 GitHub stars~3.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Loora Design Guide

    lassejlv/loora

    Build, edit, refine, troubleshoot, and review polished responsive product interfaces through the Loora MCP server and its structured Canvas schemas.

    140 GitHub stars~2.4k tokensUpdated 11 days ago
    Frontend & DesignAuto-check passed
  • Figma Connect Component

    bitovi/ai-enablement-prompts

    Generate Figma Code Connect mappings that link React components to their Figma counterparts.

    121 GitHub stars~3.3k tokensUpdated 27 days ago
    Frontend & DesignAuto-check passed
  • Figma Bridge Doctor

    hashgraph-online/awesome-codex-plugins

    Single owner of the connection between Figma Desktop and the figma-console MCP Desktop Bridge plugin, alias-agnostic, across every project.

    1.2k GitHub stars~6.7k tokensUpdated today
    Frontend & DesignAuto-check passed
  • 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.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Integrating shadcn/ui Components

    google-labs-code/stitch-skills

    Official

    Guides finding, installing, customizing and wiring up shadcn/ui components in a project, with MCP tools for the component catalog and registries.

    8.4k GitHub starsUsed in 4 repos~2.3k tokens
    Frontend & DesignAuto-check: notes

More from shepherdjerred/monorepo

All 63 skills in this repo
  • Bun Runtime Best Practices

    shepherdjerred/monorepo

    Bun runtime APIs and current operational patterns for files, processes, modules, networking, databases, tests, and deployment.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Bun Test Patterns

    shepherdjerred/monorepo

    Current Bun test runner guidance for discovery, isolation, parallelism, sharding, changed tests, mocks, timers, snapshots, coverage, DOM Testing Library, and integration teardown.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Bun Workspaces

    shepherdjerred/monorepo

    Current Bun workspace guidance for isolated and hoisted linkers, catalogs, filters, scripts, dependency classes, lockfiles, lifecycle trust, caches, publishing, TypeScript package exports, and…

    112 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Deep Research

    shepherdjerred/monorepo

    This skill should be used when the user asks to "deep research", "research this topic", "investigate thoroughly", "do a deep dive on", "comprehensive research on", "find everything about", "survey…

    112 GitHub stars~4.7k tokensUpdated today
    Auto-check: notes
  • Fish Helper

    shepherdjerred/monorepo

    Current Fish shell scripting, functions, abbreviations, completions, variables, events, configuration, plugins, testing, and safety guidance.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Gh Helper

    shepherdjerred/monorepo

    Complete GitHub operations via gh CLI - repos, issues, PRs, code search, releases, file management When user mentions GitHub, repositories, issues, PRs, gh command, code search, commits, file contents

    112 GitHub stars~4.4k tokensUpdated today
    Auto-check passed

Questions about Figma Use

What does Figma Use do?

This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma"…. Figma Use is an agent skill from shepherdjerred/monorepo. This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma", "modify Figma design", or mentions Figma design tasks.

When should I use Figma Use?

Figma Use fits situations like: asks to create a Figma design; design in Figma; make a Figma mockup; create an app icon.

How do I install Figma Use in Claude Code?

Run `npx skills add shepherdjerred/monorepo --skill figma-use -a claude-code`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/figma-use in shepherdjerred/monorepo) into .claude/skills/figma-use in your project. Claude Code loads it when a task matches its description.

How do I install Figma Use in Codex?

Run `npx skills add shepherdjerred/monorepo --skill figma-use -a codex`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/figma-use in shepherdjerred/monorepo) into .agents/skills/figma-use in your project. Codex loads it when a task matches its description.

Can I use Figma Use 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 shepherdjerred/monorepo --skill figma-use -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-use, .gemini/skills/figma-use, .github/skills/figma-use and .opencode/skills/figma-use in your project.

What does Figma Use need to run?

Going by SKILL.md and its folder, Figma Use needs the command-line tools its instructions call (osascript).

Does Figma Use 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 Use 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 Use use?

Figma Use is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Figma Use use?

About 946 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Figma Use?

Skills that share tags, products or a category with Figma Use: Wonder Blocks (Khan/wonder-blocks, 163 stars), Loora Design Guide (lassejlv/loora, 140 stars), Figma Connect Component (bitovi/ai-enablement-prompts, 121 stars) and Figma Bridge Doctor (hashgraph-online/awesome-codex-plugins, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Figma Use?

shepherdjerred (a GitHub user) maintains it in shepherdjerred/monorepo, which has 112 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 8, 2026.

Source: shepherdjerred/monorepo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.