Communitygithub.com

code-to-figma

Reconstruye las pantallas de una aplicación web en ejecución como capas nativas y editables de Figma (Auto Layout, componentes, instancias) y las compara con capturas del navegador. No es una importación de capturas ni una capa de código.

¿Qué es code-to-figma?

Esta habilidad permite a un agente de IA (como Claude Code, Cursor o Codex) tomar una aplicación web en funcionamiento y reconstruir su interfaz de usuario dentro de Figma como capas nativas y editables. A diferencia de herramientas que solo importan capturas de pantalla o generan capas de código no editables, este skill extrae el árbol DOM del navegador, identifica límites de componentes (con adaptadores para React y Vue 3), y reconstruye la interfaz utilizando Auto Layout, componentes e instancias de Figma, logrando una fidelidad visual muy alta (con diferencias reportadas de menos del 0.12%). El proceso incluye desde la configuración inicial (confirmar proyecto, pantallas, viewport y archivo Figma de destino) hasta la captura, construcción, comparación visual y auditoría final, siguiendo reglas estrictas para evitar sobrecargar la memoria del archivo Figma. Es ideal para desarrolladores y diseñadores que necesitan llevar rápidamente prototipos o interfaces existentes a Figma para iterar, documentar o colaborar, soportando proyectos con React 18/19 (incluyendo Next.js App Router), Vue 3 y otros frameworks con detección de nodos repetidos.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Code to Figma

Ejecuta el proyecto, extrae el DOM en un árbol de diseño en el navegador y luego lo reconstruye en Figma como Auto Layout y componentes editables.

Para frontends web. Los límites de componentes tienen adaptadores para Vue 3 y React (React 18 y 19 probados, incluidos Server Components de Next.js App Router; 16 y 17 tienen la misma estructura de fiber pero no están probados). Otros frameworks solo obtienen detección de nodos repetidos. Las aplicaciones nativas y las pantallas dibujadas completamente en Canvas/WebGL están fuera del alcance; usa el archivo de diseño o wireframes en su lugar.

ArchivoContenido
web-capture.mdEl proceso completo; léelo antes de empezar
screen-structure.mdReglas de estructura que debe cumplir la salida
scale-guard.mdUmbrales y condiciones de parada para el presupuesto de llamadas MCP y la memoria del archivo; léelo antes de empezar
troubleshooting.mdTabla de errores comunes; revísala cuando los resultados sean incorrectos
examples/Plantillas de configuración de captura para cuatro tipos de proyecto: mock incorporado, fixture de Playwright, dev de Nuxt, interceptando la API del backend
evals/trials.jsonCasos de regresión y líneas base; vuelve a ejecutarlos todos después de cambiar las herramientas

Pasos

  1. Confirma las entradas: el proyecto y cómo ejecutarlo, qué pantallas, el viewport y tipo de altura de cada pantalla, el archivo Figma de destino y el sistema de diseño a vincular. El usuario decide el tema y alcance; no los elijas tú mismo. Una vez que tengas el enlace de Figma, ejecuta create_session más un use_figma de solo lectura para confirmar que la cuenta con la que ha iniciado sesión MCP puede leer y escribir el archivo (si no puede abrir el archivo, usa whoami para explicar qué cuenta es y con quién compartir el archivo). Luego estima cuántas llamadas necesita este trabajo según el "presupuesto de llamadas MCP" de scale-guard.md; si el presupuesto no es suficiente, dímelo primero
  2. Inicia el proyecto, escribe la configuración, captura: ejecuta al-capture.cjs, siguiendo web-capture.md
  3. Construye primero una pantalla representativa por dispositivo, compárala con la captura del navegador y procesa en lote solo cuando coincida
  4. Compara cada pantalla después del lote: ejecuta al-diff.py; también toma una captura y verifica la sección de Componentes
  5. Audita: ejecuta audit-screens.js

Terminado cuando: cada pantalla tiene una reconstrucción, el ancho del marco raíz de cada pantalla es igual al viewport, y la pantalla representativa de cada dispositivo tiene una capa de captura de referencia; issues está vacío, o cada entrada se reporta con su causa; la sección de Componentes se ha verificado en una captura.

Reglas estrictas para escribir en Figma

La memoria de un archivo de Figma puede dispararse más allá del límite en un instante, incluso cuando el uso estático es bajo, y un archivo que explota no siempre se puede recuperar (scale-guard.md "Incidente"). Sigue estas en cada proyecto:

  1. Antes de escribir en un archivo existente, pide al usuario que guarde una versión, incluso antes de eliminar o reconstruir pantallas que construiste antes. No empieces hasta que el usuario responda que está guardado. Cuando la página de destino no tenga nada más que lo que tú mismo construiste (archivo nuevo, página en blanco), puedes omitir esto; dímelo en el informe
  2. Envía una pantalla a la vez: sube las imágenes y el SVG de datos de esta pantalla, constrúyela, confirma que los marcos temporales ALDATA- y ALIMG- se hayan eliminado, luego pasa a la siguiente. No subas todo el lote primero
  3. Si el usuario reporta una advertencia roja o modo de recuperación, detente inmediatamente. No ejecutes ni un use_figma de solo lectura hasta que el usuario confirme que el archivo está bien
  4. Detente cuando se alcance el límite de llamadas: si alguna herramienta de Figma devuelve "se alcanzó el límite de llamadas de la herramienta MCP de Figma", no reintentes ni cambies de herramienta para evitarlo. Enumera las pantallas completadas y los IDs de nodo de los marcos temporales que aún estén en el lienzo

Limitaciones conocidas

  • Los límites de componentes tienen adaptadores para Vue 3 y React; ambos requieren modo de desarrollo (las compilaciones de producción no tienen nombres de componentes y stats.json advertirá). Svelte, Angular y otros frameworks solo obtienen detección de nodos repetidos; para admitir uno, agrega una entrada a ADAPTERS en al-extract.js
  • Reglas de nomenclatura de componentes de React: un nodo DOM cuenta como límite solo cuando es el único nodo raíz del componente, y el nombre se toma del componente más externo. Los componentes que solo pasan hijos (Provider, Tooltip, ErrorBoundary), componentes de estilo styled-components/emotion, y componentes internos del router y del framework no cuentan. Los nombres de Server Components de Next.js requieren una compilación de desarrollo de React 19 (Next 15 y posteriores); con React 18 solo se capturan los componentes cliente
  • React: el proyecto demo de Vite + Radix + Tailwind 4 tiene una línea base de reconstrucción en Figma (cuatro pantallas, diferencia del 0.02–0.12% con el navegador). El proyecto de Next.js App Router está verificado solo mediante captura y empaquetado
  • Los iconos que usan un SVG como mask-image y no tienen hijos (por ejemplo, frappe-ui, clases lucide-* de UnoCSS) se convierten en vectores y se colorean con el color de fondo. Otros usos de mask-image (degradados, máscaras de mapa de bits) y clip-path no tienen equivalente; los bordes degradados y los cortes angulares se convierten en formas completas
  • Colores: se admite rgb(), más los formatos que Chrome puede devolver, como oklch(), color(srgb …), lab() y hsl(); estos últimos se convierten a sRGB a través de un canvas, y cada canal puede diferir en 1 (redondeo de 8 bits)
  • La API de Plugin no puede cambiar el ancho de un marco dentro de una instancia. Un hijo único que se estira para llenar su marco padre se cambia a Fill, los hijos que se estiran para llenar el padre se ajustan mediante padding, y los marcos de Auto Layout que son Hug en los datos se cambian a Hug; en todos los demás casos, el tamaño sigue al componente principal, y log.boxes los enumera
  • Los elementos pequeños con z-index anidados pueden terminar cubiertos; el árbol de capas no puede mover un solo hijo fuera de su padre
  • Las fuentes del sistema (ui-sans-serif) se reemplazan con Inter; los anchos de caracteres difieren ligeramente
  • font-variant-numeric: tabular-nums (cifras tabulares) no se puede activar en Figma: openTypeFeatures de la API de Plugin es de solo lectura. Las fechas, horas y cantidades salen más estrechas que en el navegador, y el texto después de ellas se desplaza 5–8px; log.drift enumera estos casos
  • La rotación y los triángulos CSS solo se manejan para elementos sin hijos (marcas de verificación, triángulos de pestañas, cuadrados pequeños), que se convierten en vectores; los contenedores rotados con hijos se colocan según su cuadro delimitador, y su contenido no se rota

Informe

  • Estructura: proporción de contenedores Auto Layout, recuento de componentes/variantes; qué áreas son absolutas (superposiciones, contenido a mitad de desplazamiento)
  • Resultados de comparación: desviación de texto, las pantallas con mayor ratio de diferencia y puntos conocidos que no se pueden reproducir. Lee el ratio de diferencia en contexto: los degradados o mask-image de mapa de bits elevan el ratio, así que explica la causa; cuando stats.json advierte que los iconos están vacíos, permite la fuente del icono y vuelve a capturar primero. Cuando una pantalla completa casi no tiene color, primero verifica si el stat devuelto por __alBuild detectó algún color (troubleshooting.md)
  • Las capturas de referencia van solo en las pantallas representativas; el resto permanece en la carpeta de salida local
  • Con una biblioteca vinculada, escribe esta parte según la sección "Informe" de figma-library-binding; sin una biblioteca, los colores y tamaños de fuente son valores codificados
  • Las pantallas se reproducen a partir de datos simulados; qué áreas se rellenaron con capturas en vivo y qué texto se cambió en los mocks
  • Qué fuente se sustituyó cuando Figma no tiene la fuente del producto
  • Escala: una línea en el formato de 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。

Skills relacionados