Pular para o conteúdo

Skill Figma Design to Code

A 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.

Oficial · Figma
AutorFigma
LicençaNo licence file; Figma Developer Terms apply
Fontefigma/mcp-server-guide · SKILL.md no GitHub
Site do projetodevelopers.figma.com/docs/figma-mcp-server
Funciona emClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lido na fonte em

A skill figma-design-to-code é a skill oficial da Figma para agentes implementarem um design do Figma em código: você passa ao agente o link de um frame, e ele cria essa tela ou componente no seu projeto. A Figma a torna pré-requisito obrigatório da ferramenta get_design_context do servidor MCP, então ela é carregada toda vez que um agente puxa um design do Figma.

Ela existe porque o código que o Figma devolve é uma referência, não um componente pronto. A skill faz o agente tratá-lo como um protótipo de alta fidelidade e não interativo: traduzir o posicionamento absoluto para o seu sistema de layout, reutilizar os componentes, tokens e mapeamentos do Code Connect que você já tem, colocar cada imagem e SVG exatamente como no design e depois conferir o resultado com uma captura de tela do design. Ela só lê do Figma; é o oposto da figma-generate-design, que leva código para o Figma.

Do SKILL.md da skill: treat returned code as a high visual fidelity non-interactive prototype

Esta é uma skill oficial de Figma. Como qualquer skill, ela dá instruções ao agente e pode incluir scripts que ele executa, então instale-a a partir da fonte indicada aqui, não de uma cópia em outro lugar.

O que ela faz

  1. Pede uma captura de tela na primeira chamada get_design_context (ou chama get_screenshot) e a usa como o alvo visual que o código final precisa atingir.
  2. Quando uma resposta vem marcada como esparsa, associa os IDs dos nós filhos à captura de tela e pede os filhos visíveis em um único lote paralelo; depois implementa só a partir dessas respostas detalhadas.
  3. Examina o seu projeto e os pacotes de bibliotecas de design instalados em busca de componentes, assets e tokens correspondentes, e os reutiliza ou combina em vez de escrever markup bruto, estilos inline ou valores fixos.
  4. Usa o componente mapeado pelo Code Connect sempre que houver um, mesmo quando conectá-lo dá mais trabalho.
  5. Baixa cada imagem estática e SVG para o seu projeto e mantém cada um no lugar e no tamanho exatos, sem deixar URLs temporárias de assets do Figma no código; imagens que vêm de dados continuam dinâmicas.
  6. Verifica só a tela ou o componente pedido: cada arquivo de asset, o seu espaço, o ponto onde é usado e o tamanho renderizado, corrigindo as diferenças dentro do escopo e anotando, sem mudar, as que não têm relação.

O que você recebe

  • Mudanças de código no seu repositório: componentes ou uma página na sua stack (React e Tailwind por padrão no Figma, adaptados ao seu projeto), além dos assets de imagem e SVG baixados.
  • Nenhuma mudança no arquivo do Figma.

Quando usar

  • Um designer entrega um frame do Figma e você quer implementá-lo no código e no design system que já tem.
  • Você usa o Code Connect e quer que os componentes mapeados sejam reutilizados em vez de recriados.
  • Tentativas anteriores de design para código geraram markup com posicionamento absoluto, ícones faltando ou links para imagens do Figma que expiraram.

Quando não usar

  • Você quer a direção oposta (código para o Figma): use a figma-generate-design.
  • O design é animado e você precisa da animação também: adicione a figma-implement-motion, que cuida do get_motion_context junto com a estrutura desta skill.
  • O alvo é SwiftUI: a skill figma-swiftui da Figma cobre especificamente a tradução entre SwiftUI e Figma.
  • Você precisa de um resultado pixel-perfect sem componentes existentes: a skill continua funcionando, mas o principal valor dela é reutilizar o que o seu projeto já tem.

O que ela exige

  • O servidor MCP do Figma conectado e com login feito. A Figma recomenda o servidor remoto; o get_design_context também existe no servidor desktop, que exige o app desktop do Figma e um assento Dev ou Full em um plano pago.
  • Uma conta no Figma com acesso ao design. Esta skill só lê, então não precisa de acesso de gravação, mas as ferramentas de leitura têm limite de uso: até 20 chamadas por mês no plano Starter ou em um assento View ou Collab, e limites diários e por minuto em assentos Dev e Full pagos.
  • O seu projeto aberto no agente, para que ele encontre componentes, tokens e o lugar certo dos assets.
  • Um link para o frame ou a camada (as URLs do Figma trazem a file key e o ID do nó).

Arquivos da skill

Arquivo ou pastaPara que serve
SKILL.mdA skill inteira, em três seções curtas: contexto (capturas de tela, respostas esparsas), implementação (reutilização, Code Connect, assets) e verificação.

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.

  • Implemente este frame do Figma como um componente React em src/components usando os nossos Button e Card existentes: <frame URL>.
  • Monte a página de configurações a partir deste link do Figma no nosso app Next.js, com Tailwind e os nossos design tokens, e baixe os ícones para public/icons.
  • Transforme este design do Figma em HTML e CSS puros, igual à captura de tela: <frame URL>.
  • Atualize o ProfileHeader.tsx para corresponder ao design mais recente do Figma; reutilize o componente Avatar mapeado pelo Code Connect.

Como instalar a skill figma-design-to-code

Conecte o servidor MCP do Figma

No Claude Code, o plugin da Figma no marketplace oficial da Anthropic adiciona o servidor MCP remoto e esta skill junto com as outras skills da Figma. Depois de instalar, execute /mcp e entre no Figma. Ou adicione o servidor com o segundo comando e copie só esta pasta: a skill não tem outros arquivos nem skill complementar para copiar.

claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcp

Cursor, Gemini CLI, VS Code e o servidor desktop

O guia da Figma instala o mesmo plugin no Cursor (/add-plugin figma) e no Gemini CLI (uma extensão, depois /mcp auth figma), e conecta o VS Code por um servidor MCP HTTP. Se a sua organização usa o servidor desktop, o endereço dele é http://127.0.0.1:3845/mcp enquanto o app desktop do Figma estiver aberto com o servidor ativado no Dev Mode.

/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide

Não serve para envio ao claude.ai nem para a Claude API

A skill só orienta as chamadas às ferramentas de design context do servidor MCP 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

  1. Abra o Claude Code em um terminal com claude.
  2. Este plugin está no marketplace oficial da Anthropic, que o Claude Code adiciona automaticamente na primeira vez que você o abre.
  3. 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
  4. Digite / e procure /figma:figma-design-to-code, ou simplesmente peça a tarefa.

Pelo shell, em vez de dentro de uma sessão:

claude plugin install figma@claude-plugins-official

O 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-generate-design, figma-generate-diagram, figma-generate-library, figma-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use, 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-design-to-code ~/.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-design-to-code 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-design-to-code .agents/skills/
AgentePasta do projetoSua pasta de usuárioObservaçõ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).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

Fontes destas instruções

Conferido com a documentação de cada fornecedor em 2026-11-14:

Reutilizar é melhor que gerar de novo

A maior parte da skill trata de não reinventar o seu projeto. Antes de editar, o agente precisa examinar os caminhos prováveis do projeto e os pacotes de bibliotecas de design instalados, reutilizar componentes, assets e tokens correspondentes e só alterá-los quando não conseguem expressar o design. Um mapeamento do Code Connect é sempre usado no nó mapeado, a menos que o componente realmente não possa ser configurado.

O posicionamento absoluto do Figma é traduzido para o layout do seu próprio projeto, a menos que o design realmente precise de posições fixas, e as partes interativas do design viram código interativo.

É nos assets que a maioria das tentativas falha

A skill é rigorosa com imagens e SVGs: cada um é baixado como a resposta de design context descreve e usado na posição exata, nunca redesenhado, embutido inline, trocado por algo parecido ou deixado apontando para uma URL temporária do Figma. Os SVGs mantêm a própria largura e altura. Um único asset substituído ou com proporção errada conta como falha na etapa de verificação.

Perguntas sobre a skill figma-design-to-code

Qual é a diferença entre a figma-design-to-code e a figma-generate-design?

Elas vão em direções opostas. A figma-design-to-code lê um design do Figma e escreve código no seu repositório. A figma-generate-design lê o seu código e monta telas editáveis no Figma. Muitas equipes instalam as duas pelo plugin da Figma.

O código sai em React?

O get_design_context da Figma devolve React e Tailwind por padrão e pode devolver outros frameworks, como Vue, HTML e CSS puros ou iOS, quando solicitado. A skill então adapta esse resultado à stack, às convenções e aos componentes existentes do seu projeto em vez de colá-lo.

Preciso de um assento pago no Figma?

Não para gravar, porque esta skill só lê. Mas as ferramentas de leitura têm limite: até 20 chamadas por mês no plano Starter ou com um assento View ou Collab. Assentos Dev e Full dos planos Professional, Organization e Enterprise têm limites diários e por minuto, que atendem ao uso regular.

Por que ela insiste em uma captura de tela?

A captura de tela é o alvo visual que o código final precisa atingir. A skill proíbe usá-la como imagem no código: a implementação precisa vir do design context detalhado, com os assets reais baixados e posicionados.

A skill figma-design-to-code é grátis?

O arquivo é grátis para instalar, mas não é de código aberto: o repositório não tem arquivo de licença e valem os Developer Terms da Figma. Ela exige uma conta no Figma e conta para os limites de uso das ferramentas de leitura do seu plano e assento.

Mais skills de IA

Skills relacionadas

Categorias de skills