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.
-
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=5Añ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 unname,slug,author,palette(lista hexadecimal) yurl. Muestra al usuario 3–5 con sus paletas y deja que elija. No elijas por ellos cuando dos candidatos se lean de manera diferente. -
Obtén la especificación estructurada.
https://styleref.io/api/v1/styles/{slug}?format=jsonCada 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 -
Escribe los colores como variables locales.
sections.colors.values.color_palette.solidColorses una lista ordenada de{hex, amount}.amountes 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 poramountdescendente. 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_levelesWCAG AAoAAA, 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. -
Escribe la tipografía como estilos de texto.
sections.typography.values.font_familyes 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 aplicafont_weights,text_case,letter_spacingytypographic_hierarchya los estilos que crees. -
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_themeesLightoDark. 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.
- 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
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 delight_shadow, que describe la luz fotográfica, no la elevación de la interfaz de usuario.border_philosophy→ tratamiento de trazo predeterminado.button_shapeybutton_hierarchy→ frames de botones y sus variantes.icon_styleyicon_weight→ qué conjunto de iconos usar y con qué peso.navigation_patternynavigation_style→ el esqueleto de diseño de la pantalla, ylayout_archetypedice qué es realmente el frame que envuelve (Dashboard,Feed,Split-screen,Master–detail,Marketing page,Canvas,Wizard / flow).content_widthestablece el ancho del frame y si el contenido va a sangre o se contiene en un contenedor.spacing_scaleydensity→ los números de auto-layout.4pt grid/8pt grides el paso del que cada valor de espacio y relleno es múltiplo;Compact…Spaciousescala qué múltiplo se usa. Constrúyelos como variables de espaciado, no como números escritos en cada frame. Cuandospatial_hierarchytambién hable de espaciado o densidad,ui_webgana — es la declaración a nivel de interfaz.corner_radius_scale→ variables de radio, aplicadas a todo el sistema.button_shapelo refina solo para botones;Mixed by componentsignifica 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_styleydata_viz_style→ constrúyelos solo cuando el campo no seaNone; definen densidad de tabla, líneas de cuadrícula de gráficos, numerales KPI y color de serie.ui_imagerydice 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_stylees comportamiento: unSkeleton shimmerobtiene un frame de esqueleto estático más una nota, nunca una animación falsa.focus_ring_stylees 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_speedyscroll_behaviordescriben 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_webesté ausente, dilo y trabaja a partir de las secciones siguientes; no inventes reglas de interfaz que el estilo nunca especificó. -
Asigna las secciones restantes que tienen representación en el lienzo. Solo estas se traducen en objetos del archivo:
Sección Escrí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_webgana en espaciado y densidadlight_shadowEstilos de efecto — pero ui_webgana donde ambos hablansurface_materialTratamiento de relleno, textura background_environmentFondos de frame guardrailsReglas estrictas de "nunca hagas esto" — obsérvalas mood_personality,output_format,references,inspiration_imagesycustom_style_itemsno se asignan a objetos del archivo. Consérvalos como contexto para la generación y para tus propios juicios. -
Conserva la especificación como contexto de generación. Para cualquier frame, diseño o imagen que generes después, pon el texto
format=defaultdelante de la solicitud como bloque de restricciones. Pégalo textualmente — está escrito para ser aplicado, y parafrasearlo pierde las restricciones. -
Atribúyelo. Deja el nombre del estilo, su autor
@handley la URL canónicastyleref.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.
-
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.
-
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. -
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 -
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.
-
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: 0 | La 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_found | La 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_required | El estilo es privado. Solo su propietario puede leerlo. Pide al usuario un estilo público, o el conector StyleRef si es suyo. |
429 rate_limited | 60 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 esperada | El 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.io | No 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 aplicado | El 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 colores | Un 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=defaultproduce 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 delimit) 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=defaultproduce 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.