Communitygithub.com

Implementar Design (Traduzir Figma para Código)

Traduz designs do Figma em código de aplicação pronto para produção com fidelidade visual 1:1. Use ao implementar código de UI a partir de arquivos Figma, quando o usuário mencionar 'implementar design', 'gerar código', 'implementar componente', fornecer URLs do Figma ou pedir para construir componentes que correspondam às especificações do Figma.

O que é Implementar Design (Traduzir Figma para Código)?

Esta habilidade fornece um fluxo de trabalho estruturado para traduzir designs do Figma em código pronto para produção com precisão de pixels. Ela garante a integração consistente com o servidor MCP do Figma, o uso adequado de tokens de design e a paridade visual 1:1 com os designs. A habilidade suporta as plataformas Claude Code, Cursor e Codex, utilizando o servidor Figma MCP para extrair contextos de design, capturar screenshots e baixar assets. O fluxo de trabalho envolve sete etapas principais: obter o ID do nó (a partir de URL ou seleção no aplicativo desktop), buscar o contexto de design, capturar uma referência visual, baixar assets necessários, traduzir para as convenções do projeto, alcançar paridade visual 1:1 e validar contra o Figma. Regras importantes incluem organização de componentes, integração com o sistema de design, qualidade de código e reutilização sobre recriação. A habilidade também aborda problemas comuns como saída truncada, incompatibilidades de design e diferenças de tokens de design, fornecendo soluções práticas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/figma-implement-design

Perguntar na sua IA favorita

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

Documentação

Implementar Design

Visão Geral

Esta habilidade fornece um fluxo de trabalho estruturado para traduzir designs do Figma em código pronto para produção com precisão de pixels. Ela garante a integração consistente com o servidor MCP do Figma, o uso adequado de tokens de design e a paridade visual 1:1 com os designs.

Limites da Habilidade

  • Use esta habilidade quando a entrega for código no repositório do usuário.
  • Se o usuário pedir para criar/editar/excluir nós dentro do próprio Figma, mude para figma-use.
  • Se o usuário pedir para construir ou atualizar uma tela de página inteira no Figma a partir de código ou de uma descrição, mude para figma-generate-design.
  • Se o usuário pedir apenas mapeamentos do Code Connect, mude para figma-code-connect-components.
  • Se o usuário pedir para criar regras de agente reutilizáveis (CLAUDE.md/AGENTS.md), mude para figma-create-design-system-rules.

Pré-requisitos

  • O servidor MCP do Figma deve estar conectado e acessível
  • O usuário deve fornecer uma URL do Figma no formato: https://figma.com/design/:fileKey/:fileName?node-id=1-2
    • :fileKey é a chave do arquivo
    • 1-2 é o ID do nó (o componente ou frame específico a ser implementado)
  • OU ao usar figma-desktop MCP: O usuário pode selecionar um nó diretamente no aplicativo desktop do Figma (nenhuma URL necessária)
  • O projeto deve ter um sistema de design ou biblioteca de componentes estabelecido (preferencialmente)

Fluxo de Trabalho Obrigatório

Siga estas etapas em ordem. Não pule etapas.

Etapa 1: Obter ID do Nó

Opção A: Analisar a partir da URL do Figma

Quando o usuário fornecer uma URL do Figma, extraia a chave do arquivo e o ID do nó para passar como argumentos para as ferramentas MCP.

Formato da URL: https://figma.com/design/:fileKey/:fileName?node-id=1-2

Extrair:

  • Chave do arquivo: :fileKey (o segmento após /design/)
  • ID do nó: 1-2 (o valor do parâmetro de consulta node-id)

Nota: Ao usar o MCP desktop local (figma-desktop), fileKey não é passado como parâmetro para as chamadas de ferramenta. O servidor usa automaticamente o arquivo atualmente aberto, portanto apenas o nodeId é necessário.

Exemplo:

  • URL: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15
  • Chave do arquivo: kL9xQn2VwM8pYrTb4ZcHjF
  • ID do nó: 42-15

Opção B: Usar a Seleção Atual do Aplicativo Desktop Figma (apenas figma-desktop MCP)

Ao usar o MCP figma-desktop e o usuário NÃO forneceu uma URL, as ferramentas usam automaticamente o nó atualmente selecionado no arquivo Figma aberto no aplicativo desktop.

Nota: A solicitação baseada em seleção só funciona com o servidor MCP figma-desktop. O servidor remoto requer um link para um frame ou camada para extrair o contexto. O usuário deve ter o aplicativo desktop do Figma aberto com um nó selecionado.

Etapa 2: Buscar Contexto do Design

Execute get_design_context com a chave do arquivo e ID do nó extraídos.

get_design_context(fileKey=":fileKey", nodeId="1-2")

Isso fornece os dados estruturados, incluindo:

  • Propriedades de layout (Auto Layout, restrições, dimensionamento)
  • Especificações tipográficas
  • Valores de cores e tokens de design
  • Estrutura e variantes de componentes
  • Valores de espaçamento e preenchimento

Se a resposta for muito grande ou truncada:

  1. Execute get_metadata(fileKey=":fileKey", nodeId="1-2") para obter o mapa de nós de alto nível
  2. Identifique os nós filhos específicos necessários a partir dos metadados
  3. Busque nós filhos individuais com get_design_context(fileKey=":fileKey", nodeId=":childNodeId")

Etapa 3: Capturar Referência Visual

Execute get_screenshot com a mesma chave do arquivo e ID do nó para uma referência visual.

get_screenshot(fileKey=":fileKey", nodeId="1-2")

Este screenshot serve como fonte da verdade para a validação visual. Mantenha-o acessível durante toda a implementação.

Etapa 4: Baixar Assets Necessários

Baixe todos os assets (imagens, ícones, SVGs) retornados pelo servidor MCP do Figma.

IMPORTANTE: Siga estas regras de assets:

  • Se o servidor MCP do Figma retornar uma fonte localhost para uma imagem ou SVG, use essa fonte diretamente
  • NÃO importe ou adicione novos pacotes de ícones - todos os assets devem vir do payload do Figma
  • NÃO use ou crie placeholders se uma fonte localhost for fornecida
  • Os assets são servidos através do endpoint de assets integrado do servidor MCP do Figma

Etapa 5: Traduzir para as Convenções do Projeto

Traduza a saída do Figma para a estrutura, estilos e convenções deste projeto.

Princípios-chave:

  • Trate a saída do MCP Figma (tipicamente React + Tailwind) como uma representação do design e comportamento, não como estilo de código final
  • Substitua classes utilitárias do Tailwind pelas utilitárias preferidas do projeto ou tokens do sistema de design
  • Reutilize componentes existentes (botões, entradas, tipografia, wrappers de ícones) em vez de duplicar funcionalidades
  • Use o sistema de cores, escala tipográfica e tokens de espaçamento do projeto de forma consistente
  • Respeite os padrões existentes de roteamento, gerenciamento de estado e busca de dados

Etapa 6: Alcançar Paridade Visual 1:1

Esforce-se para obter paridade visual de pixel perfeito com o design do Figma.

Diretrizes:

  • Priorize a fidelidade ao Figma para corresponder exatamente aos designs
  • Evite valores codificados - use tokens de design do Figma quando disponíveis
  • Quando surgirem conflitos entre os tokens do sistema de design e as especificações do Figma, prefira os tokens do sistema de design, mas ajuste espaçamentos ou tamanhos minimamente para corresponder aos visuais
  • Siga os requisitos WCAG para acessibilidade
  • Adicione documentação de componentes conforme necessário

Etapa 7: Validar Contra o Figma

Antes de marcar como concluído, valide a UI final contra o screenshot do Figma.

Lista de verificação de validação:

  • Layout corresponde (espaçamento, alinhamento, dimensionamento)
  • Tipografia corresponde (fonte, tamanho, peso, altura da linha)
  • Cores correspondem exatamente
  • Estados interativos funcionam como projetado (hover, ativo, desabilitado)
  • Comportamento responsivo segue as restrições do Figma
  • Assets renderizam corretamente
  • Padrões de acessibilidade atendidos

Regras de Implementação

Organização de Componentes

  • Coloque os componentes de UI no diretório designado do sistema de design do projeto
  • Siga as convenções de nomenclatura de componentes do projeto
  • Evite estilos inline, a menos que sejam realmente necessários para valores dinâmicos

Integração com o Sistema de Design

  • Use SEMPRE componentes do sistema de design do projeto quando possível
  • Mapeie tokens de design do Figma para tokens de design do projeto
  • Quando um componente correspondente existir, estenda-o em vez de criar um novo
  • Documente quaisquer novos componentes adicionados ao sistema de design

Qualidade do Código

  • Evite valores codificados - extraia para constantes ou tokens de design
  • Mantenha componentes componíveis e reutilizáveis
  • Adicione tipos TypeScript para props de componentes
  • Inclua comentários JSDoc para componentes exportados

Exemplos

Exemplo 1: Implementando um Componente de Botão

Usuário diz: "Implemente este componente de botão do Figma: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15"

Ações:

  1. Analisar URL para extrair fileKey=kL9xQn2VwM8pYrTb4ZcHjF e nodeId=42-15
  2. Executar get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")
  3. Executar get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") para referência visual
  4. Baixar quaisquer ícones de botão do endpoint de assets
  5. Verificar se o projeto tem um componente de botão existente
  6. Se sim, estendê-lo com uma nova variante; se não, criar novo componente usando as convenções do projeto
  7. Mapear cores do Figma para tokens de design do projeto (por exemplo, primary-500, primary-hover)
  8. Validar contra o screenshot para preenchimento, raio de borda, tipografia

Resultado: Componente de botão correspondendo ao design do Figma, integrado ao sistema de design do projeto.

Exemplo 2: Construindo um Layout de Dashboard

Usuário diz: "Construa este dashboard: https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5"

Ações:

  1. Analisar URL para extrair fileKey=pR8mNv5KqXzGwY2JtCfL4D e nodeId=10-5
  2. Executar get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") para entender a estrutura da página
  3. Identificar seções principais a partir dos metadados (cabeçalho, barra lateral, área de conteúdo, cartões) e seus IDs de nós filhos
  4. Executar get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId") para cada seção principal
  5. Executar get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") para a página inteira
  6. Baixar todos os assets (logotipos, ícones, gráficos)
  7. Construir layout usando primitivas de layout do projeto
  8. Implementar cada seção usando componentes existentes quando possível
  9. Validar comportamento responsivo contra as restrições do Figma

Resultado: Dashboard completo correspondendo ao design do Figma com layout responsivo.

Melhores Práticas

Sempre Comece com Contexto

Nunca implemente com base em suposições. Sempre busque get_design_context e get_screenshot primeiro.

Validação Incremental

Valide frequentemente durante a implementação, não apenas no final. Isso detecta problemas precocemente.

Documente Desvios

Se você precisar desviar do design do Figma (por exemplo, por questões de acessibilidade ou restrições técnicas), documente o motivo em comentários de código.

Reutilização sobre Recriação

Sempre verifique se há componentes existentes antes de criar novos. A consistência em todo o código é mais importante do que a replicação exata do Figma.

Sistema de Design Primeiro

Em caso de dúvida, prefira os padrões do sistema de design do projeto em vez da tradução literal do Figma.

Problemas Comuns e Soluções

Problema: Saída do Figma está truncada

Causa: O design é muito complexo ou tem muitas camadas aninhadas para retornar em uma única resposta. Solução: Use get_metadata para obter a estrutura do nó e, em seguida, busque nós específicos individualmente com get_design_context.

Problema: Design não corresponde após a implementação

Causa: Discrepâncias visuais entre o código implementado e o design original do Figma. Solução: Compare lado a lado com o screenshot da Etapa 3. Verifique espaçamento, cores e valores de tipografia nos dados de contexto do design.

Problema: Assets não carregam

Causa: O endpoint de assets do servidor MCP do Figma não está acessível ou as URLs estão sendo modificadas. Solução: Verifique se o endpoint de assets do servidor MCP do Figma está acessível. O servidor serve assets em URLs localhost. Use estas diretamente sem modificação.

Problema: Valores de token de design diferem do Figma

Causa: Os tokens do sistema de design do projeto têm valores diferentes daqueles especificados no design do Figma. Solução: Quando os tokens do projeto diferirem dos valores do Figma, prefira os tokens do projeto para consistência, mas ajuste espaçamento/dimensionamento para manter a fidelidade visual.

Entendendo a Implementação de Design

O fluxo de trabalho de implementação do Figma estabelece um processo confiável para traduzir designs em código:

Para designers: Confiança de que as implementações corresponderão aos seus designs com precisão de pixels. Para desenvolvedores: Uma abordagem estruturada que elimina suposições e reduz revisões de ida e volta. Para equipes: Implementações consistentes e de alta qualidade que mantêm a integridade do sistema de design.

Ao seguir este fluxo de trabalho, você garante que cada design do Figma seja implementado com o mesmo nível de cuidado e atenção aos detalhes.

Recursos Adicionais

Individual skills in this repo

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

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

Habilidades Relacionadas