Communitygithub.com

tmnhutwork/Landingpage-Photo-Retouch

Traduce diseños de Figma en código de aplicación listo para producción con fidelidad visual 1:1. Úsalo al implementar código de IU a partir de archivos Figma, cuando el usuario mencione "implementar diseño", "generar código", "implementar componente", proporcione URLs de Figma, o pida construir componentes que coincidan con las especificaciones de Figma. Para escrituras en el lienzo de Figma mediante `use_figma`, usa `figma-use`.

¿Qué es Landingpage-Photo-Retouch?

Esta habilidad proporciona un flujo de trabajo estructurado para traducir diseños de Figma en código listo para producción con precisión de píxel perfecto. Garantiza una integración consistente con el servidor MCP de Figma, el uso adecuado de tokens de diseño y una paridad visual 1:1 con los diseños. Está diseñada para desarrolladores y equipos que necesitan implementar componentes de IU, páginas completas o aplicaciones a partir de archivos Figma. La habilidad soporta tanto el servidor MCP remoto de Figma como el de escritorio (`figma-desktop`), y detalla los pasos necesarios: extraer el ID del nodo (desde una URL o desde la selección actual en la app de escritorio), obtener el contexto de diseño con `get_design_context`, capturar una referencia visual con `get_screenshot`, descargar activos, traducir el diseño a las convenciones del proyecto y validar contra la captura de pantalla. Hace hincapié en reutilizar componentes existentes, usar tokens del sistema de diseño del proyecto y mantener la paridad visual sin codificar valores fijos. Incluye pautas para manejar diseños truncados, conflictos de tokens y activos que no cargan, así como ejemplos detallados para implementar botones y paneles completos.

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

Preguntar en tu IA favorita

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

Documentación

Implementar Diseño

Resumen

Esta habilidad proporciona un flujo de trabajo estructurado para traducir diseños de Figma en código listo para producción con precisión de píxel perfecto. Garantiza una integración consistente con el servidor MCP de Figma, el uso adecuado de tokens de diseño y una paridad visual 1:1 con los diseños.

Límites de la Habilidad

  • Usa esta habilidad cuando el entregable sea código en el repositorio del usuario.
  • Si el usuario solicita crear/editar/eliminar nodos dentro de Figma, cambia a figma-use.
  • Si el usuario solicita construir o actualizar una pantalla de página completa en Figma a partir de código o una descripción, cambia a figma-generate-design.
  • Si el usuario solicita solo mapeos de Code Connect, cambia a figma-code-connect-components.
  • Si el usuario solicita redactar reglas de agente reutilizables (CLAUDE.md/AGENTS.md), cambia a figma-create-design-system-rules.

Prerrequisitos

  • El servidor MCP de Figma debe estar conectado y accesible
  • El usuario debe proporcionar una URL de Figma con el formato: https://figma.com/design/:fileKey/:fileName?node-id=1-2
    • :fileKey es la clave del archivo
    • 1-2 es el ID del nodo (el componente o marco específico a implementar)
  • O al usar el MCP figma-desktop: El usuario puede seleccionar un nodo directamente en la aplicación de escritorio de Figma (no se requiere URL)
  • El proyecto debe tener un sistema de diseño o biblioteca de componentes establecido (preferiblemente)

Flujo de Trabajo Requerido

Sigue estos pasos en orden. No omitas pasos.

Paso 1: Obtener el ID del Nodo

Opción A: Extraer de la URL de Figma

Cuando el usuario proporciona una URL de Figma, extrae la clave del archivo y el ID del nodo para pasarlos como argumentos a las herramientas MCP.

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

Extrae:

  • Clave del archivo: :fileKey (el segmento después de /design/)
  • ID del nodo: 1-2 (el valor del parámetro de consulta node-id)

Nota: Al usar el MCP de escritorio local (figma-desktop), no se pasa fileKey como parámetro a las llamadas de herramientas. El servidor usa automáticamente el archivo abierto actualmente, por lo que solo se necesita nodeId.

Ejemplo:

  • URL: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15
  • Clave del archivo: kL9xQn2VwM8pYrTb4ZcHjF
  • ID del nodo: 42-15

Opción B: Usar la Selección Actual de la Aplicación de Escritorio de Figma (solo figma-desktop MCP)

Al usar el MCP figma-desktop y el usuario NO ha proporcionado una URL, las herramientas usan automáticamente el nodo seleccionado actualmente del archivo Figma abierto en la aplicación de escritorio.

Nota: La activación basada en selección solo funciona con el servidor MCP figma-desktop. El servidor remoto requiere un enlace a un marco o capa para extraer el contexto. El usuario debe tener la aplicación de escritorio de Figma abierta con un nodo seleccionado.

Paso 2: Obtener el Contexto del Diseño

Ejecuta get_design_context con la clave del archivo y el ID del nodo extraídos.

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

Esto proporciona los datos estructurados que incluyen:

  • Propiedades de diseño (Auto Layout, restricciones, dimensionamiento)
  • Especificaciones tipográficas
  • Valores de color y tokens de diseño
  • Estructura de componentes y variantes
  • Valores de espaciado y relleno

Si la respuesta es demasiado grande o está truncada:

  1. Ejecuta get_metadata(fileKey=":fileKey", nodeId="1-2") para obtener el mapa de nodos de alto nivel
  2. Identifica los nodos secundarios específicos necesarios a partir de los metadatos
  3. Obtén nodos secundarios individuales con get_design_context(fileKey=":fileKey", nodeId=":childNodeId")

Paso 3: Capturar la Referencia Visual

Ejecuta get_screenshot con la misma clave de archivo e ID de nodo para obtener una referencia visual.

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

Esta captura de pantalla sirve como fuente de verdad para la validación visual. Mantenla accesible durante toda la implementación.

Paso 4: Descargar los Activos Requeridos

Descarga cualquier activo (imágenes, iconos, SVG) devuelto por el servidor MCP de Figma.

IMPORTANTE: Sigue estas reglas de activos:

  • Si el servidor MCP de Figma devuelve una fuente localhost para una imagen o SVG, usa esa fuente directamente
  • NO importes ni agregues nuevos paquetes de iconos: todos los activos deben provenir de la carga útil de Figma
  • NO uses ni crees marcadores de posición si se proporciona una fuente localhost
  • Los activos se sirven a través del endpoint de activos incorporado del servidor MCP de Figma

Paso 5: Traducir a las Convenciones del Proyecto

Traduce la salida de Figma al framework, estilos y convenciones de este proyecto.

Principios clave:

  • Trata la salida del MCP de Figma (típicamente React + Tailwind) como una representación del diseño y el comportamiento, no como un estilo de código final
  • Reemplaza las clases utilitarias de Tailwind con las utilidades preferidas del proyecto o los tokens del sistema de diseño
  • Reutiliza componentes existentes (botones, entradas, tipografía, envoltorios de iconos) en lugar de duplicar funcionalidades
  • Usa el sistema de color, la escala tipográfica y los tokens de espaciado del proyecto de manera consistente
  • Respeta los patrones existentes de enrutamiento, gestión de estado y obtención de datos

Paso 6: Lograr Paridad Visual 1:1

Esfuérzate por lograr una paridad visual perfecta con el diseño de Figma.

Directrices:

  • Prioriza la fidelidad a Figma para que coincida exactamente con los diseños
  • Evita valores codificados: usa tokens de diseño de Figma cuando estén disponibles
  • Cuando surjan conflictos entre los tokens del sistema de diseño y las especificaciones de Figma, prefiere los tokens del sistema de diseño pero ajusta el espaciado o los tamaños de manera mínima para que coincidan con lo visual
  • Sigue los requisitos WCAG para accesibilidad
  • Agrega documentación de componentes según sea necesario

Paso 7: Validar Contra Figma

Antes de marcar como completado, valida la IU final contra la captura de pantalla de Figma.

Lista de verificación de validación:

  • El diseño coincide (espaciado, alineación, dimensionamiento)
  • La tipografía coincide (fuente, tamaño, peso, altura de línea)
  • Los colores coinciden exactamente
  • Los estados interactivos funcionan según lo diseñado (hover, activo, deshabilitado)
  • El comportamiento responsivo sigue las restricciones de Figma
  • Los activos se renderizan correctamente
  • Se cumplen los estándares de accesibilidad

Reglas de Implementación

Organización de Componentes

  • Coloca los componentes de IU en el directorio del sistema de diseño designado del proyecto
  • Sigue las convenciones de nomenclatura de componentes del proyecto
  • Evita estilos en línea a menos que sean realmente necesarios para valores dinámicos

Integración del Sistema de Diseño

  • Usa SIEMPRE componentes del sistema de diseño del proyecto cuando sea posible
  • Mapea los tokens de diseño de Figma a los tokens de diseño del proyecto
  • Cuando exista un componente coincidente, extiéndelo en lugar de crear uno nuevo
  • Documenta cualquier nuevo componente agregado al sistema de diseño

Calidad del Código

  • Evita valores codificados: extráelos a constantes o tokens de diseño
  • Mantén los componentes componibles y reutilizables
  • Agrega tipos TypeScript para las propiedades de los componentes
  • Incluye comentarios JSDoc para los componentes exportados

Ejemplos

Ejemplo 1: Implementar un Componente de Botón

Usuario dice: "Implementa este componente de botón de Figma: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15"

Acciones:

  1. Extraer de la URL: fileKey=kL9xQn2VwM8pYrTb4ZcHjF y nodeId=42-15
  2. Ejecutar get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")
  3. Ejecutar get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") para referencia visual
  4. Descargar cualquier icono de botón desde el endpoint de activos
  5. Verificar si el proyecto tiene un componente de botón existente
  6. Si es así, extenderlo con la nueva variante; si no, crear un nuevo componente usando las convenciones del proyecto
  7. Mapear colores de Figma a tokens de diseño del proyecto (p. ej., primary-500, primary-hover)
  8. Validar contra la captura de pantalla: relleno, radio de borde, tipografía

Resultado: Componente de botón que coincide con el diseño de Figma, integrado con el sistema de diseño del proyecto.

Ejemplo 2: Construir un Diseño de Panel

Usuario dice: "Construye este panel: https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5"

Acciones:

  1. Extraer de la URL: fileKey=pR8mNv5KqXzGwY2JtCfL4D y nodeId=10-5
  2. Ejecutar get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") para entender la estructura de la página
  3. Identificar las secciones principales a partir de los metadatos (encabezado, barra lateral, área de contenido, tarjetas) y sus IDs de nodos secundarios
  4. Ejecutar get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId") para cada sección principal
  5. Ejecutar get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") para la página completa
  6. Descargar todos los activos (logotipos, iconos, gráficos)
  7. Construir el diseño usando las primitivas de diseño del proyecto
  8. Implementar cada sección usando componentes existentes cuando sea posible
  9. Validar el comportamiento responsivo contra las restricciones de Figma

Resultado: Panel completo que coincide con el diseño de Figma con diseño responsivo.

Mejores Prácticas

Siempre Comenzar con Contexto

Nunca implementes basándote en suposiciones. Siempre obtén primero get_design_context y get_screenshot.

Validación Incremental

Valida con frecuencia durante la implementación, no solo al final. Esto detecta problemas temprano.

Documentar Desviaciones

Si debes desviarte del diseño de Figma (por ejemplo, por accesibilidad o restricciones técnicas), documéntalo en comentarios de código.

Reutilizar Sobre Recrear

Siempre verifica si existen componentes antes de crear nuevos. La consistencia en todo el código base es más importante que la réplica exacta de Figma.

Priorizar el Sistema de Diseño

En caso de duda, prefiere los patrones del sistema de diseño del proyecto sobre la traducción literal de Figma.

Problemas Comunes y Soluciones

Problema: La salida de Figma está truncada

Causa: El diseño es demasiado complejo o tiene demasiadas capas anidadas para devolverlo en una sola respuesta. Solución: Usa get_metadata para obtener la estructura del nodo, luego obtén nodos específicos individualmente con get_design_context.

Problema: El diseño no coincide después de la implementación

Causa: Discrepancias visuales entre el código implementado y el diseño original de Figma. Solución: Compara uno al lado del otro con la captura de pantalla del Paso 3. Verifica los valores de espaciado, colores y tipografía en los datos del contexto de diseño.

Problema: Los activos no cargan

Causa: El endpoint de activos del servidor MCP de Figma no es accesible o las URL se están modificando. Solución: Verifica que el endpoint de activos del servidor MCP de Figma sea accesible. El servidor sirve activos en URLs localhost. Úsalas directamente sin modificación.

Problema: Los valores de los tokens de diseño difieren de Figma

Causa: Los tokens del sistema de diseño del proyecto tienen valores diferentes a los especificados en el diseño de Figma. Solución: Cuando los tokens del proyecto difieran de los valores de Figma, prefiere los tokens del proyecto para mantener la consistencia, pero ajusta el espaciado/dimensionamiento para mantener la fidelidad visual.

Entendiendo la Implementación del Diseño

El flujo de trabajo de implementación de Figma establece un proceso confiable para traducir diseños a código:

Para diseñadores: Confianza en que las implementaciones coincidirán con sus diseños con precisión de píxel perfecto. Para desarrolladores: Un enfoque estructurado que elimina las conjeturas y reduce las revisiones de ida y vuelta. Para equipos: Implementaciones consistentes y de alta calidad que mantienen la integridad del sistema de diseño.

Al seguir este flujo de trabajo, aseguras que cada diseño de Figma se implemente con el mismo nivel de cuidado y atención al detalle.

Recursos Adicionales

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.

Skills relacionados