Communitygithub.com

styleref-figma

Aplica un estilo visual o de marca con nombre a un archivo de Figma — escribe su paleta como variables de color locales, sus reglas tipográficas como estilos de texto y su especificación completa como contexto de generación para que los nuevos frames mantengan la marca. También captura el estilo ya presente en una selección en una especificación reutilizable y portátil.

¿Qué es styleref-figma?

StyleRef es una especificación de estilo estructurada (colores, tipografía, estado de ánimo, iluminación, lenguaje de formas, materiales, composición) publicada en styleref.io y legible como texto plano o JSON. Esta skill permite aplicar un estilo de marca o visual a un archivo de Figma sin necesidad de una biblioteca de diseño publicada, un plugin o un conector. Para ello, primero resuelve el estilo mediante búsqueda en la API de styleref.io (con paginación básica y categorías predefinidas) o a partir de un enlace `styleref.io/share/{slug}`. Luego escribe la paleta de colores como variables locales, las reglas tipográficas como estilos de texto y la sección `ui_web` (que incluye tema claro/oscuro, superficies, acentos, sombras, espaciado, bordes, iconos, navegación, etc.) como variables, efectos y estilos. Finalmente, conserva toda la especificación como contexto de generación para que cualquier frame, layout o imagen generada posteriormente se mantenga fiel a la marca. La skill también ofrece un flujo inverso: a partir de una selección existente en el lienzo, lee los valores reales (colores, tipografía, radios, sombras, etc.) y los estructura en la misma especificación StyleRef, lista para ser reutilizada. Es importante destacar que la skill no inventa reglas que el usuario no haya proporcionado, no trabaja con selecciones vacías ni oculta información sobre el tipo de fuente o los roles de color propuestos; siempre atribuye el estilo a su autor original.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/StyleRef/styleref-figma-skill/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

StyleRef — aplicar una marca o estilo visual al lienzo de Figma

Un StyleRef es una especificación de estilo estructurada — colores, tipografía, estado de ánimo, luz, lenguaje de formas, materiales, composición — publicada en styleref.io y legible como texto plano o JSON. Es lo que una biblioteca de diseño aún no es: una descripción portátil de un aspecto visual, utilizable antes de que existan los componentes, y utilizable fuera de Figma en cualquier herramienta de IA que genere imágenes.

Esta skill hace: encontrar un estilo, escribir su paleta y reglas tipográficas en el archivo como variables y estilos locales reales, y llevar la especificación completa como contexto para que todo lo que se genere después se mantenga fiel a la marca. También lee una selección y escribe el estilo que ya está usando en la misma forma estructurada.

Esta skill no hace: inventar reglas de marca que el usuario no haya dado, reestilizar capas que el usuario no seleccionó, reemplazar una biblioteca de diseño publicada, ni generar imágenes por sí misma. Cuando una biblioteca publicada con componentes y variables ya cubre el aspecto visual, dilo y usa la biblioteca como fuente de verdad.

Cuándo usar esto

  • El usuario pide que algo tenga la marca, sea coherente o tenga una estética con nombre.
  • El usuario nombra un estilo, un movimiento artístico o pega un enlace styleref.io/share/....
  • El usuario quiere una paleta y una escala tipográfica para empezar y aún no tiene biblioteca.
  • El usuario quiere escribir el aspecto visual de un frame existente para poder reutilizarlo — en este archivo, en otro archivo o en una herramienta de imagen con IA.
  • El usuario está explorando la expresión de marca que los componentes aún no capturan.

Vía A — aplicar un estilo al archivo

Ejecuta esto cuando el usuario nombre un estilo o pida un aspecto visual que necesites buscar.

  1. Resuelve el estilo. Si el usuario pegó un enlace styleref.io/share/{slug}, toma el slug de él. De lo contrario, busca:

    https://styleref.io/api/v1/styles?query={palabras}&limit=5

    Añade &category={categoría} para acotar. Categorías válidas: Brand identity, UI/UX, Graphic design, Illustration, Packaging design, Photography, Fine art, 3D visualization, Character design, Cinematography, Game art, Social copy. La respuesta proporciona a cada coincidencia un name, slug, author, palette (lista hexadecimal) y url. Muestra al usuario 3–5 con sus paletas y deja que elija. No elijas por ellos cuando dos candidatos se lean de manera diferente.

  2. Obtén la especificación estructurada.

    https://styleref.io/api/v1/styles/{slug}?format=json

    Cada valor que escribas en el lienzo proviene de aquí. Obtén también el formato de texto cuando vayas a generar frames o imágenes después:

    https://styleref.io/api/v1/styles/{slug}?format=default&compact=1

  3. Escribe los colores como variables locales. sections.colors.values.color_palette.solidColors es una lista ordenada de {hex, amount}. amount es la proporción prevista de la composición — una proporción, no un rol semántico. Crea una colección con el nombre del estilo y una variable de color por cada color hexadecimal, ordenadas por amount descendente. Propón nombres de roles (surface, accent, ink) como sugerencia y di que son tuyos, no de la especificación. También aplica las reglas de color no hexadecimales — saturation_range, contrast_strategy, gradient_policy, color_temperature, shadow_color — como restricciones en todo lo que dibujes; no son variables.

    Si accessibility_level es WCAG AA o AAA, es un requisito, no una preferencia: verifica los pares de texto sobre fondo según esa proporción a medida que los asignes, y di qué pares has comprobado. Cuando un par de la paleta no pueda cumplirlo, dilo y propón una solución en lugar de enviar el par en silencio.

  4. Escribe la tipografía como estilos de texto. sections.typography.values.font_family es una categoría ("Display / Decorativa", "Sans Geométrica"), nunca un nombre de fuente con licencia. Elige un tipo de letra concreto que ya esté disponible en el archivo, o uno de los predeterminados de Figma, y dile al usuario qué fuente elegiste y que la especificación nombró una categoría, no esa fuente. Luego aplica font_weights, text_case, letter_spacing y typographic_hierarchy a los estilos que crees.

  5. Escribe la capa de interfaz desde ui_web. Esta es la sección que tiene más de Figma: treinta y tres campos que ya son vocabulario propio de Figma. Léela antes de dibujar un solo frame:

    • color_theme es Light o Dark. Un StyleRef lleva una paleta y, por tanto, un tema — no hay un segundo conjunto de valores para el modo opuesto. Construye una colección de un solo modo. Si el usuario quiere claro y oscuro, di que el estilo define un tema y ofrece construir el otro modo a partir de valores que él proporcione; nunca lo deduzcas por ti mismo. Una paleta invertida es una marca diferente con el mismo nombre, y el usuario no puede detectarlo después.
      • Los estilos antiguos pueden llevar aún una etiqueta de dos temas. Confía en la paleta, no en la etiqueta: juzga a partir de los propios hexadecimales — el marcado como fondo de página, o el dominante por amount — y di que el estilo está mal etiquetado.
    • background_tone → el relleno base de la página/lienzo. surface_layers → cuántas variables de superficie necesitas (Flat = una, Two-layer = página + tarjeta, Three-layer = página + tarjeta + elevado). No inventes una cuarta.
    • accent_strategy → cuántas variables de acento, y si son un acento funcional o un conjunto contextual. semantic_colors → variables de error/advertencia/éxito/información, solo hasta el nivel que nombran los campos.
    • elevation_approach, shadow_technique, shadow_weight, glass_blur_effect → los estilos de efecto. Estos anulan cualquier cosa que hayas inferido de light_shadow, que describe la luz fotográfica, no la elevación de la interfaz de usuario.
    • border_philosophy → tratamiento de trazo predeterminado. button_shape y button_hierarchy → frames de botones y sus variantes. icon_style y icon_weight → qué conjunto de iconos usar y con qué peso.
    • navigation_pattern y navigation_style → el esqueleto de diseño de la pantalla, y layout_archetype dice qué es realmente el frame que envuelve (Dashboard, Feed, Split-screen, Master–detail, Marketing page, Canvas, Wizard / flow). content_width establece el ancho del frame y si el contenido va a sangre o se contiene en un contenedor.
    • spacing_scale y density → los números de auto-layout. 4pt grid / 8pt grid es el paso del que cada valor de espacio y relleno es múltiplo; Compact… Spacious escala qué múltiplo se usa. Constrúyelos como variables de espaciado, no como números escritos en cada frame. Cuando spatial_hierarchy también hable de espaciado o densidad, ui_web gana — es la declaración a nivel de interfaz.
    • corner_radius_scale → variables de radio, aplicadas a todo el sistema. button_shape lo refina solo para botones; Mixed by component significa que la escala es deliberada por elemento, así que indica tu asignación en lugar de elegir un radio.
    • card_style → si el contenido se coloca en tarjetas, y si son con borde, sombra, teñidas o de cristal. input_field_style → el componente de control de formulario (Outlined, Filled / tinted, Underline only, Borderless on surface).
    • data_display_style y data_viz_style → constrúyelos solo cuando el campo no sea None; definen densidad de tabla, líneas de cuadrícula de gráficos, numerales KPI y color de serie. ui_imagery dice qué va en los espacios de imagen — None (pure UI) significa déjalos fuera en lugar de rellenarlos con fotografía de placeholder.
    • empty_state_style → un frame real que dibujas. loading_style es comportamiento: un Skeleton shimmer obtiene un frame de esqueleto estático más una nota, nunca una animación falsa.
    • focus_ring_style es un artefacto de accesibilidad, no decoración. Constrúyelo y nunca lo omitas para que una pantalla se vea más limpia.
    • hover_treatment, animation_philosophy, transition_speed y scroll_behavior describen comportamiento, que un frame estático no puede contener. Regístralos como notas en el lienzo o en tu respuesta — no los falsifiques como estilos ni los descartes en silencio.

    Cuando ui_web esté ausente, dilo y trabaja a partir de las secciones siguientes; no inventes reglas de interfaz que el estilo nunca especificó.

  6. Asigna las secciones restantes que tienen representación en el lienzo. Solo estas se traducen en objetos del archivo:

    SecciónEscríbela como
    colorsVariables de color + reglas de relleno
    typographyEstilos de texto
    ui_webModos de variable, variables de superficie/acento/semánticas, estilos de efecto, botones, iconos, navegación, anillos de foco — ver paso 5
    container_boundaryRelleno del frame, tratamiento de esquinas, comportamiento de recorte
    shape_languageRadio de esquina, decisiones geométricas
    stroke_systemPesos de trazo y remates
    spatial_hierarchyCuadrícula y composición — pero ui_web gana en espaciado y densidad
    light_shadowEstilos de efecto — pero ui_web gana donde ambos hablan
    surface_materialTratamiento de relleno, textura
    background_environmentFondos de frame
    guardrailsReglas estrictas de "nunca hagas esto" — obsérvalas

    mood_personality, output_format, references, inspiration_images y custom_style_items no se asignan a objetos del archivo. Consérvalos como contexto para la generación y para tus propios juicios.

  7. Conserva la especificación como contexto de generación. Para cualquier frame, diseño o imagen que generes después, pon el texto format=default delante de la solicitud como bloque de restricciones. Pégalo textualmente — está escrito para ser aplicado, y parafrasearlo pierde las restricciones.

  8. Atribúyelo. Deja el nombre del estilo, su autor @handle y la URL canónica styleref.io/share/... en algún lugar visible para el usuario — una nota en el lienzo o en tu respuesta. La API devuelve esa URL con cada respuesta.

Vía B — capturar el estilo ya presente en el lienzo

Ejecuta esto cuando el usuario quiera escribir el aspecto visual de una selección existente. Esto no necesita ninguna llamada de red.

  1. Requiere una selección. Si no hay nada seleccionado, pide al usuario que seleccione los frames que representan el aspecto visual. No adivines a partir de toda la página.

  2. Lee lo que realmente hay — rellenos y sus proporciones aproximadas, estilos de texto y sus pesos y mayúsculas/minúsculas, radios de esquina, pesos de trazo, valores de sombra, ritmo de espaciado, tratamiento de fondo.

    Si la selección es una interfaz, lee también la capa de interfaz, porque esa es la mitad que solo una paleta de colores no transmite: cuántos niveles de superficie apila el diseño, si la profundidad proviene de sombra, desenfoque o contraste simple, si los bordes están presentes o implícitos, la forma del botón y cuántos rangos de botón hay, el estilo y peso de los iconos, el patrón de navegación y si existen anillos de foco. Esos se convierten en la sección ui-and-web. Anota los que buscaste y no encontraste — una interfaz sin estado de foco visible es un hallazgo que vale la pena informar, no un espacio en blanco que pasar por alto.

  3. Escríbelo en la estructura de secciones de StyleRef, usando solo las secciones para las que tengas evidencia real. Deja el resto fuera; una sección vacía es honesta, una adivinada no lo es.

    output-format, mood-and-personality, colors, typography, light-and-shadow, spatial-structure, shape-language, stroke-system, surface-and-material, background-and-environment, voice-and-language, camera-and-motion, post-processing, artistic-mediums, ui-and-web, container-and-boundary, references, inspiration, guardrails, custom

  4. Separa lo que mediste de lo que inferiste. Los valores hexadecimales y los radios se miden. "Seguro, editorial, contenido" se infiere — márcalo como tu interpretación y deja que el usuario lo corrija.

  5. Ofrece el siguiente paso. La especificación capturada es reutilizable fuera de este archivo — en otro archivo de Figma, o como bloque de estilo para una herramienta de imagen o texto con IA. Indica al usuario que visite https://styleref.io para guardarlo como un StyleRef real, que es también lo que lo hace direccionable por una URL en lugar de copiar y pegar.

Afirmaciones honestas — no incumplas estas

El usuario repetirá lo que le digas, así que tiene que ser verdad.

  • Nunca afirmes una mejora de antes/después. No hay una línea base sin estilo con la que comparar, y no mediste una.
  • Nunca afirmes que el estilo produce una salida idéntica o coincidente en diferentes herramientas de IA. Modelos distintos renderizan la misma especificación de manera diferente. La afirmación precisa es que un estilo es portátil — una definición, pegada en cualquier lugar — y coherente dentro de una misma herramienta, porque cada generación recibe las mismas restricciones explícitas.
  • Nunca presentes un valor inferido como uno especificado. El tipo de letra que elegiste, los nombres de roles que propusiste y el estado de ánimo que leíste de una selección son tuyos. Dilo.
  • Nunca afirmes que el archivo ahora coincide exactamente con la referencia. Aplicaste una especificación; no reproduciste una imagen.
  • Nunca inventes una paleta complementaria oscura (o clara). Un estilo lleva un conjunto de colores. Invertirlos o rededucirlos produce una marca diferente con el mismo nombre, y es el tipo de invención que un usuario no puede detectar después.

Cuando algo sale mal

Cada uno de estos debería terminar con el usuario pudiendo actuar, no con un error pegado en su cara.

Qué ocurrióQué hacer
La búsqueda devuelve count: 0La respuesta lista availableCategories. Reintenta con una consulta más amplia o una categoría. Después de dos intentos vacíos, di que la galería no tiene una coincidencia cercana y ofrece la Vía B en su lugar.
404 not_foundLa referencia era incorrecta. Una referencia es un slug de compartir o una URL /share — nunca el nombre de un estilo o @autor/nombre. Vuelve a ejecutar la búsqueda para obtener un slug válido.
403 auth_requiredEl estilo es privado. Solo su propietario puede leerlo. Pide al usuario un estilo público, o el conector StyleRef si es suyo.
429 rate_limited60 solicitudes/minuto por IP. Espera los segundos de Retry-After y reintenta una vez. Si persiste, pide al usuario que abra https://styleref.io/share/{slug}.md y pegue el contenido, o que espere y vuelva a intentarlo.
La respuesta JSON no tiene la estructura esperadaEl esquema de StyleRef es estable a través de versiones, pero un estilo puede haber sido editado manualmente. Lee lo que haya, procesa los campos conocidos y omite los desconocidos; nunca bloquees la operación por un campo extraño.
El usuario pega un enlace que no es de styleref.ioNo lo busques. Di que este flujo de trabajo solo funciona con enlaces de styleref.io y ofrece buscar por nombre o categoría en su lugar.
El usuario pide un cambio que contradice el estilo aplicadoEl estilo es el origen, no una sugerencia. Explica la contradicción usando los campos de la especificación. Si el usuario insiste, aplica el cambio de todos modos, pero di explícitamente que el frame resultante ya no se ajusta a [nombre del estilo] y ofrece empezar de nuevo si la desviación fue accidental.
La paleta tiene menos de 2 coloresUn estilo sin contraste no puede ser aplicado como variables de forma significativa. Di que la paleta tiene menos de 2 colores y pregunta si el usuario quiere continuar de todos modos o elegir un estilo diferente con la paleta completa. Si continúa, escribe los colores disponibles y deja claro lo que falta.
El usuario pega un slug: abc (sin URL)Reconoce el slug, obtén la especificación y procede. Un slug desnudo que coincide con un estilo es suficiente. El 404 se maneja más arriba.

Notas de implementación

  • Figma REST API, no WebSocket. Todas las llamadas a la API de Figma se autentican con el token de acceso existente. Las mutaciones (crear variables, crear estilos, dibujar frames) utilizan los endpoints de la API REST de Figma.
  • Todas las URLs de la API de StyleRef llevan el prefijo https://styleref.io. La API devuelve slugs de estilo, no URLs completas; constrúyelas con ese prefijo.
  • El formateo format=default produce hasta ~5000 tokens de texto de restricción. Inclúyelo textualmente en cualquier solicitud de generación que realices después de aplicar el estilo. Es más denso en restricciones de lo que parece.
  • La paginación. La respuesta de búsqueda tiene count — si hay más de 5 resultados, añade &offset=0 (o el siguiente múltiplo de limit) para ver más. Muéstrale al usuario un máximo de 12 antes de decir que la galería no tiene una coincidencia cercana.
  • El formateo format=default produce texto con viñetas. Pégalo directamente sin reformatear. Tiene un propósito: poner el mismo texto delante de un modelo de lenguaje cada vez que se genera contenido.

Skills relacionados