Communitygithub.com

Code to Figma

Recria as telas de uma aplicação web em execução como camadas nativas do Figma (Auto Layout, componentes, instâncias) e as compara com capturas de tela do navegador — não é uma importação de imagem ou camada de código. Use quando o usuário pedir para 'transformar esta página em Figma', 'code to Figma', 'enviar esta tela para o Figma' ou 'recriar a UI no Figma'.

O que é Code to Figma?

O **Code to Figma** é uma skill de agente especializada em reconstruir a interface de usuário de aplicações web diretamente no Figma como camadas nativas editáveis. Diferente de ferramentas que apenas importam capturas de tela ou geram camadas de código, esta skill extrai a árvore DOM do navegador, identifica componentes (com adaptadores para Vue 3 e React — incluindo React 18/19 e Server Components do Next.js App Router), e recria a estrutura com Auto Layout, componentes e instâncias no Figma. Ela suporta captura de uma ou múltiplas telas simultaneamente e realiza uma comparação pixel a pixel com a captura de tela do navegador para garantir fidelidade visual. A skill é ideal para desenvolvedores e designers que desejam converter rapidamente interfaces web em componentes de design reutilizáveis no Figma, mantendo a capacidade de edição e a estrutura de layout responsiva. O fluxo de trabalho inclui etapas de configuração, captura, construção, comparação e auditoria, com regras rigorosas para escrita no Figma, como enviar uma tela por vez e solicitar salvamento antes de modificar arquivos existentes. Há limitações conhecidas para frameworks não React/Vue, elementos com `clip-path` ou `mask-image` não SVG, e rotação de containers com filhos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byby325/code-to-figma-ui-states/tree/HEAD/skills/code-to-figma

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Code to Figma faz?

Execute o projeto, extraia o DOM em uma árvore de layout no navegador e recrie-o no Figma como Auto Layout e componentes editáveis.

Para front-ends web. Os limites de componentes têm adaptadores para Vue 3 e React (React 18 e 19 testados, incluindo Server Components do Next.js App Router; 16 e 17 têm a mesma estrutura de fiber, mas não foram testados). Outros frameworks recebem apenas detecção de nós repetidos. Aplicativos nativos e telas desenhadas inteiramente em Canvas/WebGL estão fora do escopo; use o arquivo de design ou wireframes.

ArquivoConteúdo
web-capture.mdO processo completo; leia antes de começar
screen-structure.mdRegras de estrutura que a saída deve atender
scale-guard.mdLimites e condições de parada para o orçamento de chamadas MCP e memória de arquivo; leia antes de começar
troubleshooting.mdTabela de consulta de armadilhas; verifique quando os resultados estiverem errados
examples/Modelos de configuração de captura para quatro tipos de projeto: mock embutido, fixture Playwright, dev Nuxt, interceptando a API do backend
evals/trials.jsonCasos de regressão e linhas de base; execute todos novamente após alterar as ferramentas

Etapas

  1. Confirme as entradas: o projeto e como executá-lo, quais telas, viewport e tipo de altura de cada tela, o arquivo Figma de destino e o sistema de design a ser vinculado. O usuário decide o tópico e o escopo; não os escolha você. Assim que tiver o link do Figma, execute create_session mais um use_figma somente leitura para confirmar que a conta com a qual o MCP está autenticado pode ler e escrever no arquivo (se não conseguir abrir o arquivo, use whoami para explicar qual conta é e com quem compartilhar o arquivo). Em seguida, estime quantas chamadas esse trabalho precisa de acordo com scale-guard.md "Orçamento de chamadas MCP"; se o orçamento não for suficiente, informe primeiro
  2. Inicie o projeto, escreva a configuração, capture: execute al-capture.cjs, seguindo web-capture.md
  3. Construa primeiro uma tela representativa por dispositivo, compare-a com a captura de tela do navegador e faça o lote somente quando corresponder
  4. Compare cada tela após o lote: execute al-diff.py; também capture a tela e verifique a seção Componentes
  5. Audite: execute audit-screens.js

Concluído quando: cada tela tem uma reconstrução, a largura do frame raiz de cada tela é igual ao viewport e a tela representativa de cada dispositivo tem uma camada de captura de tela de referência; issues está vazio, ou cada entrada é relatada com sua causa; a seção Componentes foi verificada em uma captura de tela.

Regras rígidas para escrever no Figma

A memória de um arquivo Figma pode disparar além do limite em um instante, mesmo quando o uso estático é baixo, e um arquivo que explode nem sempre pode ser recuperado (scale-guard.md "Incidente"). Siga estas em todos os projetos:

  1. Antes de escrever em um arquivo existente, peça ao usuário para salvar uma versão, inclusive antes de deletar ou reconstruir telas que você construiu anteriormente. Não comece até que o usuário responda que está salvo. Quando a página de destino não tiver nada além do que você mesmo construiu (arquivo novo, página em branco), você pode pular isso; informe isso no relatório
  2. Envie uma tela por vez: carregue as imagens e o SVG de dados desta tela, construa-a, confirme que os frames temporários ALDATA- e ALIMG- foram deletados, depois faça a próxima. Não carregue o lote inteiro primeiro
  3. Se o usuário relatar um aviso vermelho ou modo de recuperação, pare imediatamente. Não execute nem mesmo um use_figma somente leitura até que o usuário confirme que o arquivo está bem
  4. Pare quando o limite de chamadas for atingido: se qualquer ferramenta Figma retornar "limite de chamadas da ferramenta MCP Figma atingido", não tente novamente e não mude de ferramenta para contornar. Liste as telas concluídas e os IDs de nós dos frames temporários ainda na tela

Limitações conhecidas

  • Os limites de componentes têm adaptadores para Vue 3 e React; ambos exigem modo de desenvolvimento (builds de produção não têm nomes de componentes, e stats.json emitirá um aviso). Svelte, Angular e outros frameworks recebem apenas detecção de nós repetidos; para oferecer suporte a um, adicione uma entrada em ADAPTERS no al-extract.js
  • Regras de nomenclatura de componentes React: um nó DOM conta como limite apenas quando é o único nó raiz do componente, e o nome é obtido do componente mais externo. Componentes que apenas passam filhos (Provider, Tooltip, ErrorBoundary), componentes de estilo styled-components/emotion e componentes internos do roteador e do framework não contam. Nomes de Server Components Next.js exigem uma build de desenvolvimento React 19 (Next 15 ou superior); com React 18, apenas componentes cliente são capturados
  • React: o projeto de demonstração Vite + Radix + Tailwind 4 tem uma linha de base de reconstrução Figma (quatro telas, 0,02–0,12% de diferença do navegador). O projeto Next.js App Router é verificado apenas através de captura e empacotamento
  • Ícones que usam um SVG como mask-image e não têm filhos (ex.: frappe-ui, classes lucide-* do UnoCSS) são convertidos em vetores e coloridos com a cor de fundo. Outros usos de mask-image (fades gradientes, máscaras bitmap) e clip-path não têm equivalente; bordas desbotadas e cortes angulares tornam-se formas completas
  • Cores: rgb() é suportado, além dos formatos que o Chrome pode retornar, como oklch(), color(srgb …), lab() e hsl(); estes últimos são convertidos para sRGB através de um canvas, e cada canal pode diferir em 1 (arredondamento de 8 bits)
  • A API do Plugin não pode alterar a largura de um frame dentro de uma instância. Um filho único que se estica para preencher o frame pai é alterado para Fill, filhos que se esticam para preencher o pai são ajustados através de padding, e frames Auto Layout que estão em Hug nos dados são alterados para Hug; em todos os outros casos, o tamanho segue o componente principal, e log.boxes os lista
  • Elementos pequenos com z-index aninhado podem acabar cobertos; a árvore de camadas não pode mover um único filho para fora de seu pai
  • Fontes do sistema (ui-sans-serif) são substituídas por Inter; as larguras dos caracteres diferem ligeiramente
  • font-variant-numeric: tabular-nums (figuras tabulares) não pode ser ativado no Figma: openTypeFeatures da API do Plugin é somente leitura. Datas, horas e valores saem mais estreitos do que no navegador, e o texto após eles desloca 5–8px; log.drift lista estes
  • Rotação e triângulos CSS são tratados apenas para elementos sem filhos (marcas de seleção, triângulos de abas, pequenos quadrados), que são convertidos em vetores; containers rotacionados com filhos são dispostos por sua caixa delimitadora, e seu conteúdo não é rotacionado

Relatório

  • Estrutura: proporção de containers Auto Layout, contagem de componentes/variantes; quais áreas são absolutas (overlays, conteúdo em meio ao scroll)
  • Resultados da comparação: desvio de texto, as telas com maior taxa de diferença e pontos conhecidos que não podem ser reproduzidos. Leia a taxa de diferença no contexto: gradientes ou mask-image bitmap aumentam a taxa, então explique a causa; quando stats.json avisar que ícones estão vazios, permita a fonte do ícone e recapture primeiro. Quando uma tela inteira quase não tem cor, verifique primeiro se o stat retornado por __alBuild capturou alguma cor (troubleshooting.md)
  • Capturas de tela de referência vão apenas nas telas representativas; as demais permanecem na pasta de saída local
  • Com uma biblioteca vinculada, escreva esta parte conforme a seção "Relatório" do figma-library-binding; sem biblioteca, cores e tamanhos de fonte são valores codificados
  • As telas são reproduzidas a partir de dados mock; quais áreas foram preenchidas com capturas de tela ao vivo e qual cópia foi alterada nos mocks
  • Qual fonte foi substituída quando o Figma não tem a fonte do produto
  • Escala: uma linha no formato scale-guard.md

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

figma-library-binding

Bind Figma screens to a design system library — tokens only on exact value matches, swap icons and components for library versions, and list unmatched values for designers instead of snapping to the nearest token. Use when the user asks to "bind tokens", "use library components" or "find unbound colors". 把 Figma 畫面綁到專案的 design system library:顏色、圓角、邊框、間距、字級完全相同才綁 token,圖示和元件換成 library 版本,沒有對應的值列給設計決定,不取最近值。Use when 使用者要「綁 library」「綁 token」「換成 design system 元件」「檢查沒綁 variable 的顏色」,或 code-to-figma、figma-state-board 的畫面要綁 design system。

figma-state-board

Inventory every UI state of a feature from its code and lay them out on one Figma canvas (a state board) — real screens for states the prototype already handles, plus a gap check of missing error, empty and loading states, split into spec-required and suggested. Use when the user asks for a "state board", "all states of this feature in Figma", "which error screens are missing", or to update an existing board. 從任何產品專案的程式碼盤點一個功能的所有狀態,在 Figma 產出或更新「情境稿」:原型(通常是 mock data 做的)已經有的狀態畫真實畫面,原型缺的狀態全列進「缺漏檢查」,再分「規格有寫」(規格要求、原型漏做)和「建議補」(規格和原型都沒提的錯誤、空狀態、載入等)。Use when 使用者要「做情境稿」「把所有狀態/狀況畫到 Figma」「state board」「檢查缺了哪些 error 畫面」,或要依新規則增修既有情境稿。只要狀態清單用 state-discovery,只要把畫面轉進 Figma 用 code-to-figma。

Habilidades Relacionadas