Skill Figma Use (use_figma)
A skill base por trás de toda gravação no Figma: as regras que um agente segue ao rodar scripts da Plugin API no seu arquivo pelo use_figma.
Oficial · Figma| Autor | Figma |
|---|---|
| Licença | No licence file; Figma Developer Terms apply |
| Fonte | figma/mcp-server-guide · SKILL.md no GitHub |
| Site do projeto | developers.figma.com/docs/figma-mcp-server |
| Funciona em | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lido na fonte em |
A skill figma-use é a skill base oficial da Figma para a ferramenta MCP use_figma, que permite a um agente de IA rodar JavaScript na Plugin API do Figma dentro do seu arquivo: criar e editar frames, textos, auto layout, componentes, variáveis e estilos, ou examinar a estrutura de um arquivo. A Figma a marca como pré-requisito obrigatório: o agente a carrega antes de toda chamada use_figma.
Ela é um livro de regras, não um fluxo de trabalho. Lista os erros que fazem os scripts de canvas falharem (fontes não carregadas, cores na faixa 0–255, troca de página do jeito errado, esquecer de retornar os IDs dos nós) e como evitá-los, e aponta para as skills de tarefa que se apoiam nela: figma-generate-design para telas, figma-generate-library para itens de design system, figma-use-motion para animação. Ela exige o servidor MCP remoto do Figma e uma conta no Figma.
Do SKILL.md da skill: Use the `use_figma` tool to execute JavaScript in Figma files via the Plugin API.
O que ela faz
- Define as regras básicas de todo script use_figma: JavaScript puro com await no nível superior, resultados devolvidos com return (o console.log não aparece) e todo ID de nó criado ou alterado retornado para que as próximas chamadas o encontrem.
- Evita as falhas comuns: carregar a fonte antes de qualquer edição de texto, cores como valores de 0 a 1, fills e strokes reatribuídos como arrays novos, dimensionamento do auto layout definido só depois que o nó entra no pai, novos frames de nível superior posicionados longe da origem.
- Explica como lidar com páginas (trocar de página no máximo uma vez por script e dividir o trabalho em várias páginas em chamadas paralelas) e as diferenças entre arquivos do Figma Design, FigJam e Slides.
- Diz ao agente qual skill complementar carregar: figma-generate-design para qualquer mudança visível no design, figma-generate-library para componentes e tokens reutilizáveis, a skill de transformações 3D para perspectiva e inclinação.
- Cobre o trabalho de design system (componentes, variáveis, estilos de texto e de efeito) com referências dedicadas e mantém pequenas as leituras grandes, retornando primeiro IDs e contagens.
- Define a recuperação de erros: se é seguro repetir um script que falhou ou se o agente precisa ler o canvas primeiro para ver o que mudou.
O que você recebe
- Nada por si só: ela molda a forma como o agente escreve os scripts use_figma. O resultado é o que a tarefa pediu, criado ou editado no seu arquivo do Figma.
Quando usar
- Qualquer tarefa de agente que grave em um arquivo do Figma pelo servidor MCP do Figma: ela é carregada automaticamente antes do use_figma.
- Edições programáticas que um designer acharia tediosas: renomear camadas em massa, vincular cores a variáveis, corrigir auto layout, auditar a estrutura de um arquivo.
- Você está escrevendo a sua própria skill para o Figma e quer as regras base em que as oficiais se apoiam.
Quando não usar
- Montar telas inteiras ou bibliotecas de design system: use a figma-generate-design ou a figma-generate-library, que carregam a figma-use sozinhas.
- Transformar um design do Figma em código: isso só lê o arquivo e é trabalho da figma-design-to-code.
- Você usa só o servidor MCP desktop do Figma: ele não grava no canvas, então o use_figma não está disponível nele.
O que ela exige
- O servidor MCP remoto do Figma (https://mcp.figma.com/mcp) conectado e com login feito; a documentação da Figma diz que gravar no canvas só funciona com o servidor remoto.
- Uma conta no Figma com acesso de edição ao arquivo. Gravar fora dos seus rascunhos exige um assento Full; gravar é grátis durante o beta, e a Figma diz que depois será pago, cobrado por uso.
- Para mudanças visíveis no design, a figma-generate-design junto (a skill a torna obrigatória), e a figma-generate-library para itens de biblioteca. O plugin do Figma instala todas elas.
Arquivos da skill
| Arquivo ou pasta | Para que serve |
|---|---|
SKILL.md | 21 regras críticas, regras de páginas, modos do editor, APIs eficientes (node.query, node.set, createAutoLayout, capturas de tela inline), o fluxo incremental, a recuperação de erros e uma checklist prévia. |
references/gotchas.md | Todas as armadilhas conhecidas, com código errado e correto, a começar pela receita de carregamento de fontes para edições de texto. |
references/common-patterns.md | Estruturas de scripts prontas para uso: formas, texto, auto layout, variáveis, componentes, fluxos de várias etapas. |
references/component-patterns.md | Conjuntos de variantes, propriedades de componente, instance swap e como descobrir componentes existentes. |
references/variable-patterns.md | Coleções, modos, escopos, aliases e vínculo de variáveis. |
references/working-with-design-systems/ | Nove guias curtos sobre usar e criar componentes, variáveis, estilos de texto e estilos de efeito. |
references/plugin-api-standalone.d.ts | As tipagens completas da Plugin API (cerca de 400 KB), pesquisadas em busca de assinaturas exatas em vez de lidas inteiras. |
Licença conforme encontrada no repositório em 2026-11-15: No licence file; Figma Developer Terms apply.
Prompts de exemplo
Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.
- Neste arquivo do Figma, renomeie as camadas que ainda têm nomes padrão como “Frame 12” com nomes descritivos baseados no conteúdo e liste o que você mudou.
- Vincule todos os preenchimentos azuis com cor fixa da página Pricing à nossa variável color/brand/primary.
- Liste as páginas, os componentes e as coleções de variáveis deste arquivo para planejarmos uma limpeza.
- Converta os cards do frame Features para auto layout com espaçamento de 16 px, mantendo a aparência atual.
Como instalar a skill figma-use
Instale com o plugin do Figma ou junto com as skills complementares
A figma-use raramente é instalada sozinha. O plugin da Figma para o Claude Code adiciona o servidor MCP remoto e todas as skills da Figma de uma vez; depois de instalar, execute /mcp e entre no Figma.
Se você copiar as pastas à mão, os comandos abaixo também copiam a figma-generate-design e a figma-generate-library, porque a figma-use encaminha para elas o trabalho visível de design e o trabalho de biblioteca.
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcpNo Cursor, no Gemini CLI e no VS Code
O guia da Figma instala o mesmo plugin no Cursor (/add-plugin figma no chat do agente) e como extensão do Gemini CLI (depois /mcp auth figma). No VS Code, adicione um servidor MCP HTTP com a mesma URL e use o modo agente do Copilot.
/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guideNão serve para envio ao claude.ai nem para a Claude API
A skill só faz sentido com a ferramenta use_figma do servidor MCP remoto do Figma. O sandbox de skills da Claude API não tem acesso à rede, e não verificamos uma configuração no claude.ai.
Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:
Claude Code: pelo marketplace de plugins
- Abra o Claude Code em um terminal com
claude. - Este plugin está no marketplace oficial da Anthropic, que o Claude Code adiciona automaticamente na primeira vez que você o abre.
- Instale o plugin. O Claude Code mostra os detalhes primeiro: confira o que ele vai adicionar (skills, hooks, servidores MCP) e escolha se ele é para você, para todos neste repositório ou só para você neste repositório.
/plugin install figma@claude-plugins-official - Digite / e procure
/figma:figma-use, ou simplesmente peça a tarefa.
Pelo shell, em vez de dentro de uma sessão:
claude plugin install figma@claude-plugins-officialO plugin é instalado inteiro, então outras skills vêm junto, incluindo figma-3d-transforms, figma-code-connect, figma-code-workflows, figma-create-new-file, figma-design-to-code, figma-generate-design, figma-generate-diagram, figma-generate-library, figma-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use-figjam, figma-use-motion, figma-use-slides.
Claude Code: copie a pasta para a sua pasta de skills
Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).
git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p ~/.claude/skills
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-generate-design ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-generate-library ~/.claude/skills/O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /figma-use ou apenas descreva a tarefa.
No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.
Codex, Gemini CLI, Cursor e GitHub Copilot
Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:
git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p .agents/skills
cp -R mcp-server-guide/skills/figma-use .agents/skills/
cp -R mcp-server-guide/skills/figma-generate-design .agents/skills/
cp -R mcp-server-guide/skills/figma-generate-library .agents/skills/| Agente | Pasta do projeto | Sua pasta de usuário | Observações |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente). |
Fontes destas instruções
Conferido com a documentação de cada fornecedor em 2026-11-14:
Como é um script de canvas seguro
Todo script é pequeno o bastante para ser repetido, começa trocando para a sua página uma única vez, carrega as fontes que usa, faz as mudanças e retorna os IDs que criou ou alterou. Trabalhos relacionados podem ir juntos em uma chamada quando repetir não causaria problema; o trabalho é dividido nos limites entre páginas ou depois de uma falha real.
As conferências vêm das evidências que o script retorna (IDs, contagens, nomes, tamanhos), mais, normalmente, uma captura de tela depois da composição e outra depois de uma correção visual, em vez de uma captura a cada etapa.
Arquivos grandes sem respostas enormes
As leituras amplas retornam só IDs, nomes, tipos e contagens; os detalhes dos IDs escolhidos vêm em uma chamada posterior, e cada inventário (variáveis, estilos, componentes, páginas) é retornado separadamente. A skill manda o agente medir o tamanho de uma resposta antes de retorná-la, em vez de cortá-la sem avisar.
Perguntas sobre a skill figma-use
O que é o use_figma?
O use_figma é a ferramenta de gravação de uso geral do servidor MCP do Figma. O agente envia um trecho de JavaScript, o Figma o executa na Plugin API dentro do seu arquivo e devolve o que o script retornar. Funciona em arquivos do Figma Design, FigJam, Slides e Specs, e só no servidor remoto.
Preciso da figma-use se já tenho a figma-generate-design?
Sim. A figma-generate-design e a figma-generate-library exigem a figma-use antes de qualquer script de canvas, porque a figma-use contém as regras da Plugin API de que elas dependem. O plugin da Figma instala todas juntas.
Por que a Figma a chama de pré-requisito obrigatório?
Os scripts de canvas falham de jeitos difíceis de depurar: uma edição de texto gera erro se a fonte não estiver carregada, uma cor com valor 255 está fora da faixa, uma troca de página com o setter errado gera erro, e um script que não retorna os IDs dos nós deixa a próxima chamada às cegas. A skill antecipa essas regras para que o agente não precise aprendê-las na tentativa e erro.
Ela edita quadros do FigJam e o Figma Slides?
O use_figma funciona nos três editores, mas cada um aceita tipos de nós diferentes. A figma-use cobre o Figma Design e as diferenças; para FigJam e Slides, a Figma oferece as skills figma-use-figjam e figma-use-slides.
A skill figma-use é grátis?
Os arquivos são grátis para instalar, mas não são de código aberto: não há arquivo de licença e valem os Developer Terms da Figma. Você precisa de uma conta no Figma e de um assento Full para gravar fora dos seus rascunhos, e a Figma diz que gravar no canvas é grátis durante o beta e depois será um recurso pago, cobrado por uso.
Mais skills de IA
Skills relacionadas
Skill Figma Generate Design
Oficial · FigmaA skill da Figma para criar ou atualizar telas em um arquivo do Figma a partir do seu código, usando os componentes e variáveis do seu design system.Skill Figma Generate Library
Oficial · FigmaA skill da Figma para criar um design system no Figma a partir do seu código: variáveis, modos claro e escuro, estilos e componentes com variantes.Skill Figma Use Motion
Oficial · FigmaA skill da Figma para animar camadas dentro de um arquivo do Figma com IA: keyframes, estilos de animação, easing, revelação de texto e duração da timeline.Skill Figma Design to Code
Oficial · FigmaA skill da Figma para transformar um frame do Figma em código no seu projeto, reutilizando os seus componentes e assets em vez de colar markup gerado.Design de miniaturas skill
Comunidade · Frank HeijdenrijkPlaneje miniaturas de vídeo honestas e legíveis no celular, com teste comparativo nativo.Design e modelos skill
Comunidade · Frank HeijdenrijkDefina kit de marca reutilizável, família de modelos e fluxo de produção para gráficos sociais recorrentes.