Communitygithub.com

figma-designer

Diseña en Figma como un diseñador profesional: variables reales, estilos de texto, auto layout y componentes sobre un sistema visual fijo (escala tipográfica y de radio tipo Tailwind, tokens de espaciado, tokens de color de dos capas, reglas de botones y estados).

¿Qué es figma-designer?

Esta habilidad convierte a cualquier agente de IA en un diseñador de Figma disciplinado que sigue un sistema de diseño fijo, asegurando coherencia visual y tokenización completa. Está diseñada para usarse con el servidor MCP de Figma y establece reglas precisas para tipografía (escala Tailwind), espaciado (variables de espaciado), radio de esquina (variables de radio), color (sistema de dos capas con modos claro/oscuro), y componentes interactivos con estados. La habilidad fuerza un flujo de trabajo estructurado: primero verificar y reutilizar activos existentes, luego crear fundaciones (variables y estilos), construir sección por sección, y vincular todo a tokens en lugar de valores fijos. Incluye reglas de accesibilidad (contraste 4.5:1), higiene de archivos (capas con nombres significativos, páginas organizadas) y una lista de verificación automática antes de finalizar. Soporta las plataformas Figma (Claude Code, Cursor, Codex) a través del Figma MCP y es ideal para diseñar pantallas, landing pages, componentes, sistemas de diseño o cualquier UI.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamsabbirhasann/ai-design-skills-main/tree/HEAD/skills/figma-designer

Preguntar en tu IA favorita

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

Documentación

Figma Designer

Estas son las reglas propias del diseñador para trabajar en Figma. Se superponen a las habilidades oficiales de Figma y no las reemplazan.

  • Carga figma-use antes de cualquier llamada use_figma. Contiene las reglas de la API de plugins (rangos de color, carga de fuentes, dimensiones de layout). Esta habilidad solo añade reglas de diseño.
  • Para pantallas y páginas completas, carga también figma-generate-design. Para bibliotecas de componentes y tokens, carga también figma-generate-library.
  • Los nombres y valores exactos de los tokens están en Referencia de tokens al final de este archigo. Léelo antes de crear o vincular cualquier variable o estilo de texto.

Flujo de trabajo

  1. Revisa el archivo primero. Lista las colecciones de variables locales y los estilos de texto, y busca en las bibliotecas del archivo (search_design_system) variables, estilos y componentes. Reutiliza lo que exista antes de crear algo nuevo.

  2. Configura las bases si faltan. Crea todo lo siguiente antes de construir cualquier pantalla:

    • las variables de spacing y radius
    • las dos capas de color (Core Colors, luego Color System con modos Claro y Oscuro)
    • los estilos de texto

    Claro y oscuro son modos de variable, nunca dos conjuntos de colores hardcodeados.

    • Muestra los tokens en el lienzo. Coloca un frame Foundations en la página Foundations, de la misma manera que los componentes están en su propio frame. Dentro de él, añade una sección de auto layout para cada colección:
      • Core Colors: una fila por paleta, un color por tono
      • Color System: una fila por grupo, con los modos Claro y Oscuro lado a lado usando modos de variable explícitos en dos columnas
      • spacing: una barra por token, dimensionada a su valor
      • radius: un cuadrado por token, con ese radio
      • Estilos de texto: una línea de muestra por estilo
    • Vincula las muestras para que se actualicen con los tokens. Cada color de relleno está vinculado a su variable. Cada barra de espaciado y cada muestra de radio está vinculada a su variable. Cada muestra de texto usa su estilo. Cuando el usuario edita un token, el marco se actualiza solo.
    • Etiquetas: cada muestra está etiquetada con su nombre de token y, para Color System, su alias (Surface/Primary → Grayscale/870). El texto no puede vincularse a un valor de color, por lo que las etiquetas hexadecimales no se actualizan solas. Vuelve a sincronizar las etiquetas cada vez que crees, renombres o cambies tokens.
  3. Construye sección por sección. Haz primero el hero, luego una sección por paso. Nunca construyas una página completa en una sola pasada. Toma captura de pantalla después de cada sección y corrígela antes de continuar.

  4. Usa auto layout en todas partes. Todos los frames con hijos usan auto layout. El padding y el gap están vinculados a variables de espaciado, nunca a números escritos.

  5. Vincula, no escribas.

    • Vincula cada relleno, trazo, radio, padding y gap a una variable.
    • Cada capa de texto utiliza un estilo de texto.
    • Vincula los diseños solo a tokens de Color System, nunca directamente a Core Colors.
  6. Autoverificación antes de finalizar. Ejecuta la lista de verificación al final de este archivo, corrige cada fallo, luego informa qué se construyó y qué se omitió.

Tipografía

  • Fuentes: cualquier fuente está permitida. Usa la que el usuario o la marca nombre; verifícala con figma.listAvailableFontsAsync() antes de cargarla.
  • Una sola tipografía por archivo a menos que el usuario pida un par. Geist Mono está permitida junto a la fuente principal solo para código, datos o números.
  • Sin estilos itálicos. Sin pesos por encima de negrita.
  • Los tamaños provienen solo de la escala tipográfica de Tailwind: 12, 14, 16, 18, 20, 24, 30, 36, 48, 60, 72, 96, 128. Si un tamaño cae entre pasos, redondea al paso inferior y usa su altura de línea.
  • Estilos de texto. Crea los estilos nombrados en Referencia de tokens → Estilos de texto (Heading 1 a 6, Title 1 a 5, Body 1 a 6, Button-lg/md/sm/Xsm, Caption 1 a 5). Usa los nombres exactamente, incluyendo mayúsculas.
    • Agrúpalos en carpetas por tipo, para que el panel muestre Heading / Heading 1, Body / Body 4, Button / Button-md.
    • Cada capa de texto usa uno de estos estilos. Nunca establezcas un tamaño o peso suelto; cambiar el peso en una capa con estilo desvincula el estilo.
  • Qué grupo usar:
    • Heading: encabezados de página y sección, de mayor a menor. Heading 1 es el hero.
    • Title: títulos de tarjetas, títulos de elementos de lista, etiquetas que encabezan un bloque, elementos de navegación.
    • Body: texto corrido. Dentro de cada tamaño, 1 es el peso más fuerte y el último es regular.
    • Button: texto dentro de botones únicamente. Los botones principales usan Button-md; los botones pequeños de encabezado usan Button-sm.
    • Caption: metadatos, texto de ayuda, insignias, marcas de tiempo, letra pequeña.
  • Nuevos estilos. Si un proyecto necesita uno, añade el siguiente número en su grupo (por ejemplo Body 7), construido a partir de un paso de escala. Nunca inventes un nombre nuevo o un tamaño fuera de escala.
  • Copia:
    • Sin guiones dentro del texto.
    • Sin una sola palabra sola en la última línea de un encabezado. Divide los encabezados manualmente en puntos significativos (usa un salto de línea en el texto, no un frame más estrecho).
    • El encabezado hero (Heading 1) no tiene puntos, ni al final ni entre frases. Separa dos ideas con un salto de línea: See the slop / Decide what to fix, no See the slop. Decide what to fix.

Espaciado

  • Usa solo las variables numéricas spacing/*: 0, 2, 4, 8, 12, 16, 24, 32, 40, 48, 64, 80, 96. Nada intermedio.
  • Vincula paddingTop/Right/Bottom/Left e itemSpacing a ellas con setBoundVariable. Asigna a las variables de espaciado el ámbito GAP, que cubre tanto el padding como el gap.
  • Cuando un valor de diseño caiga entre tokens, redondea al token más cercano y vincúlalo.
  • Los botones principales usan 8 de padding vertical (spacing/75) y 12 horizontal (spacing/100).

Radio de esquina

  • Usa solo los valores de radio de Tailwind (0, 2, 4, 6, 8, 12, 16, 24, full), como variables radius/* con el ámbito CORNER_RADIUS. Vincula cada esquina (topLeftRadius…).
  • Regla de radio anidado. Cuando una forma está dentro de otra y el espacio entre ellas es menor de 32: radio interior = radio exterior − espacio Aplícala solo cuando el resultado sea mayor que 2. Ejemplo: una tarjeta con radio 16 y padding 8 da a los elementos interiores un radio 8.
  • Verifica esto en cada frame anidado: lee el radio y el padding del padre, calcula el radio del hijo y establécela a la variable radius/* correspondiente.

Color

Estructura de tokens: dos capas, en cada archivo

Los nombres y la estructura son fijos. Los valores hexadecimales siguen la marca del usuario. Lista completa de nombres: Referencia de tokens → Color.

  1. Colección Core Colors: paletas en bruto. Primary, Secondary, Accent, Grayscale, y las paletas semánticas Red (error), Green (éxito) y Yellow (advertencia).
    • Cada paleta tiene al menos 10 tonos, desde 00 (casi blanco) hasta 1000 (casi negro). 500 es el tono base.
    • Construye los tonos a partir de los colores base de la marca.
    • Los colores transparentes también viven aquí, como una paleta Grayscale-Alpha (700-16 … 700-80) con la opacidad almacenada en la variable. Un alias no puede añadir opacidad, por lo que Overlay/* alias a estos.
  2. Colección Color System: tokens semánticos con modos Light y Dark. Cada valor es un alias a un Core Color, nunca un hexadecimal en bruto.
    • Grupos: Border/, Surface/, Action/, Text/, Icon/, Overlay/.
    • Cada rol tiene un token base más las variantes que necesita: -Hover, -Click o -Selected, -Disabled, -Subtle, -Inverted.
  • Los diseños se vinculan solo a tokens de Color System. Un cambio de marca entonces solo modifica Core Colors.
  • Nombra los tokens por rol, nunca por color en bruto (no Surface/Blue 500).
  • Limita el ámbito de las variables a lo que colorean: FRAME_FILL/SHAPE_FILL para superficies, TEXT_FILL para texto, STROKE_COLOR para bordes. Nunca dejes ALL_SCOPES.

Superficies

  • Fondos en modo oscuro, solo estos: #000000 · #181818 · #1F1F1F · #272727 · #313131 · #131209

  • Sin degradados de fondo. Las superficies son planas. Esto incluye botones y superposiciones de desvanecimiento.

  • El encabezado hero es la única excepción de degradado, solo en el texto, de izquierda a derecha:

    • tema oscuro #FFFFFF → #9B9B9B
    • tema claro #000000 → #666666

    Vincula ambas paradas del degradado a variables de color (boundVariables.color en cada parada) para que el degradado cambie con el modo.

  • Un color de acento, mantenido por debajo del 80% de saturación.

  • Los bordes van completamente alrededor o no van. Nunca un borde de un solo lado en una tarjeta. Para dividir filas, usa un rectángulo de 1 px relleno con un token Border/*, no un trazo de un solo lado.

Contraste y accesibilidad

  • Texto del cuerpo: al menos 4.5:1 contra su fondo.
  • Texto grande (24 y más, o 18 negrita y más) y partes de UI (iconos, bordes de entrada, anillos de enfoque): al menos 3:1.
  • En encabezados con degradado, verifica el contraste en el extremo más claro del degradado, no en el más oscuro.
  • Nunca confíes solo en el color para mostrar el estado. Combínalo con un icono, etiqueta o cambio de peso.
  • Los objetivos táctiles tienen al menos 44 × 44 en frames móviles.
  • Si un color de marca falla el contraste con texto blanco, usa un tono más oscuro de la misma paleta para el token Action/* en lugar de cambiar el texto.

Layout

  • Ancho máximo del encabezado hero y subtítulo 680.
  • Sin etiqueta de ceja (la pequeña píldora o etiqueta sobre un encabezado, como ● Design QA, not a redesign) por defecto. Añádela solo cuando el usuario lo pida, o cuando una imagen de inspiración que el usuario haya subido muestre una.
  • Los frames de escritorio tienen 1440 de ancho, con un contenedor de contenido centrado de 1200 a 1280.
  • Añade frames de 768 y 390 cuando la pantalla necesite versiones responsivas.
  • No predetermines tres tarjetas iguales en una fila. Considera un zigzag de dos columnas, una cuadrícula asimétrica o un diseño bento.
  • Alinea elementos compartidos en tarjetas lado a lado: títulos, precios, listas y botones comienzan en la misma Y.

Iconos

  • Usa Phosphor, Solar o Iconamoon. Nunca Material Icons o Material Symbols.
  • Usa un solo grosor de trazo en todo el archivo.
  • Importa los iconos como SVG (createNodeFromSvg) y recoloréalos con un token Icon/* vinculado. Nunca redibujes un icono desde primitivas.

Componentes y estados

  • Cualquier cosa que se use más de una vez es un componente. Expón su texto como propiedades del componente.

  • Componentes interactivos obtienen variantes para Default, Hover, Pressed, Focus, Disabled. Las entradas también obtienen Error y Filled.

  • Botones son un conjunto de componentes con estas dos propiedades, cada combinación presente (25 variantes por tamaño):

    • Type = Primary | Secondary | Tertiary | Error | Warning
    • State = Default | Hover | Pressed | Focus | Disabled

    Vincula los rellenos a Action/* (por ejemplo Action/Primary, Action/Primary-Hover, Action/Primary-Click, Action/Primary-Disabled), los bordes a Border/* y las etiquetas a Text/*. Focus añade un anillo visible (trazo exterior de 2 px con una relación de contraste de 3:1 o mejor), no solo un cambio de color.

  • Vistas de datos obtienen estados Loading (un esqueleto con la forma del layout real), Empty (una vista de inicio compuesta) y Error.

Movimiento (solo prototipo)

  • Usa Smart Animate con el bezier personalizado 0.22, 1, 0.36, 1:
    • 500 ms para cambios de layout
    • 300 ms para color u opacidad
  • Nunca uses los ajustes preestablecidos lineales o de facilidad predeterminados de Figma.

Contenido

  • Copia real en borrador, nunca texto de relleno.
  • Usa nombres, marcas y números creíbles para la industria del producto. Evita cifras sospechosamente redondas y nombres de stock como «Acme».
  • Relleno prohibido: «revolucionar», «potenciar», «vanguardia», «sin esfuerzo», «transforma tu flujo de trabajo», «lleva al siguiente nivel», «aprovechar el poder», «de clase mundial».
  • Mayúscula inicial para encabezados y botones.

Landing pages

Cuando la tarea sea una landing page, sigue también la habilidad landing-page-design del usuario para la estructura de la página y la copia (preguntas de ingesta, orden de las secciones, reglas de CTA). Eso incluye la gran sección de lema obligatoria con una revelación palabra por palabra, mostrada como una interacción de prototipo. Si esa habilidad no está disponible, pídele al usuario que la proporcione antes de planificar las secciones.

Higiene del archivo

  • Nombra cada capa de manera significativa (Pricing / Card / Pro). Nunca dejes Frame 427, Group 3, Vector o Rectangle 1.
  • Colecciones de variables: spacing, radius, Core Colors y Color System, con modos Light y Dark en Color System.
  • Los estilos de texto usan los nombres anteriores, agrupados en carpetas por tipo.
  • Una página por área: Foundations, Components, Screens.
  • Coloca los nuevos frames de nivel superior en espacio claro del lienzo, nunca sobre el trabajo existente. No elimines ni muevas las capas existentes del usuario a menos que se te pida.

Lista de verificación (ejecutar antes de informar)

  • Cada capa de texto usa un estilo de texto nombrado (Heading, Title, Body, Button, Caption) en la escala Tailwind
  • Cada padding y gap está vinculado a una variable de espaciado
  • Cada radio está vinculado a una variable de radio, y los radios anidados siguen la fórmula
  • Cada relleno y trazo está vinculado a un token de Color System (nunca un hexadecimal en bruto o un Core Color), y los modos Claro y Oscuro funcionan ambos
  • Las paletas de Core Colors tienen al menos 10 tonos cada una, y cada token de Color System es un alias
  • El frame Foundations muestra cada token y estilo de texto, con muestras vinculadas a sus variables y etiquetas sincronizadas
  • El contraste pasa 4.5:1 para el cuerpo y 3:1 para texto grande y partes de UI
  • Sin degradados de fondo, sin bordes de un solo lado, sin itálicas
  • Encabezado hero y subtítulo limitados a 680, el encabezado hero no tiene puntos, y no hay etiquetas de ceja a menos que se pidan o se muestren en una imagen de inspiración subida
  • Los componentes interactivos tienen todas las variantes de estado, y los botones tienen todos los 5 tipos × 5 estados
  • Iconos de Phosphor, Solar o Iconamoon con un solo grosor de trazo
  • Sin copia de relleno, sin capa llamada Frame o Group

Referencia de tokens

Los nombres son fijos. Los valores hexadecimales de color siguen la marca del usuario; los valores de espaciado, radio y tipo son fijos.

Espaciado

Colección spacing, un modo, FLOAT, ámbito GAP.

TokenValor
spacing/00
spacing/252
spacing/504
spacing/758
spacing/10012
spacing/20016
spacing/30024
spacing/40032
spacing/50040
spacing/60048
spacing/70064
spacing/80080
spacing/90096

Radio

Colección radius, un modo, FLOAT, ámbito CORNER_RADIUS.

TokenValor
radius/00
radius/22
radius/44
radius/66
radius/88
radius/1212
radius/1616
radius/2424
radius/full9999

Estilos de texto

La fuente es la única del archivo, de la escala Tailwind. Los nombres exactos son:

  • Heading: Heading 1, Heading 2, Heading 3, Heading 4, Heading 5, Heading 6
  • Title: Title 1, Title 2, Title 3, Title 4, Title 5
  • Body: Body 1, Body 2, Body 3, Body 4, Body 5, Body 6
  • Button: Button-lg, Button-md, Button-sm, Button-Xsm
  • Caption: Caption 1, Caption 2, Caption 3, Caption 4, Caption 5

Cada estilo usa el tamaño de fuente de la escala Tailwind correspondiente y la altura de línea predeterminada para ese tamaño. Los Heading y Title usan un peso de fuente más fuerte; Body usa el peso regular (el último de su grupo es regular); Button usa un peso medio o negrita según el tamaño. Las alturas de línea no están tokenizadas, pero deben ser consistentes en todo el archivo para el mismo estilo.

Color

Colección Core Colors, un modo, ámbito ALL_SCOPES (aunque se espera que los tokens se usen con ámbitos específicos en la práctica).

Paletas y tonos mínimos:

  • Primary: 00, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
  • Secondary: 00, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
  • Accent: 00, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
  • Grayscale: 00, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
  • Red: 100, 200, 300, 400, 500, 600, 700, 800, 900
  • Green: 100, 200, 300, 400, 500, 600, 700, 800, 900
  • Yellow: 100, 200, 300, 400, 500, 600, 700, 800, 900
  • Grayscale-Alpha: 700-16, 700-32, 700-48, 700-64, 700-80

Colección Color System, modos Light y Dark, ámbito según corresponda.

Estructura de grupos (cada grupo tiene tokens base más variantes -Hover, -Click/-Selected, -Disabled, -Subtle, -Inverted según sea necesario):

  • Border/
    • Border/Primary
    • Border/Secondary
    • Border/Subtle
    • Border/Error
    • Border/Disabled
  • Surface/
    • Surface/Primary
    • Surface/Secondary
    • Surface/Accent
    • Surface/Error
    • Surface/Warning
    • Surface/Success
    • Surface/Disabled
  • Action/
    • Action/Primary
    • Action/Primary-Hover
    • Action/Primary-Click
    • Action/Primary-Disabled
    • Action/Secondary
    • Action/Secondary-Hover
    • Action/Secondary-Click
    • Action/Secondary-Disabled
    • Action/Tertiary
    • Action/Tertiary-Hover
    • Action/Tertiary-Click
    • Action/Tertiary-Disabled
    • Action/Error
    • Action/Error-Hover
    • Action/Error-Click
    • Action/Error-Disabled
    • Action/Warning
    • Action/Warning-Hover
    • Action/Warning-Click
    • Action/Warning-Disabled
  • Text/
    • Text/Primary
    • Text/Secondary
    • Text/Accent
    • Text/Error
    • Text/Warning
    • Text/Disabled
    • Text/Inverted
  • Icon/
    • Icon/Primary
    • Icon/Secondary
    • Icon/Accent
    • Icon/Disabled
    • Icon/Inverted
  • Overlay/
    • Overlay/Hover
    • Overlay/Click
    • Overlay/Dim

Cada token en Color System es un alias a un token en Core Colors (por ejemplo, Surface/Primary puede ser un alias a Grayscale/870 en modo Claro y Grayscale/100 en modo Oscuro).

Skills relacionados