Communitygithub.com

styleref-figma

Appliquer un style visuel ou une identité de marque nommé(e) à un fichier Figma : écriture de la palette en variables de couleur locales, des règles typographiques en styles de texte, et conservation de la spécification complète comme contexte de génération pour que les nouvelles trames restent conformes à la marque.

Qu'est-ce que styleref-figma ?

Cette compétence permet d'appliquer un style visuel structuré (appelé StyleRef) à un canvas Figma, ou de capturer le style d'une sélection existante pour le réutiliser. Elle utilise l'API publique de styleref.io pour récupérer les spécifications d'un style — couleurs, typographie, UI/Web, ombres, espacements — et les transforme en variables locales, styles de texte et effets dans Figma. Aucun compte ni plugin n'est requis. Elle est conçue pour les cas où l'utilisateur n'a pas encore de bibliothèque de composants, mais souhaite une cohérence visuelle (marque, éditorial, etc.). Elle ne doit jamais inventer de valeurs, ni prétendre à une correspondance parfaite entre outils ou avant/après. Elle prend en charge deux modes : l'application d'un style depuis un lien ou une recherche, et la capture d'un style depuis une sélection Figma.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

StyleRef — appliquer une identité ou un style visuel au canvas Figma

Un StyleRef est une spécification de style structurée — couleurs, typographie, ambiance, lumière, langage formel, matériaux, composition — publiée sur styleref.io et lisible sous forme de texte brut ou JSON. C'est ce qu'une bibliothèque de design n'est pas encore : une description portable d'un look, utilisable avant que des composants n'existent, et utilisable en dehors de Figma dans n'importe quel outil d'IA générant des images.

Ce que fait cette compétence : trouver un style, écrire sa palette et ses règles typographiques dans le fichier sous forme de variables et styles locaux réels, et conserver la spécification complète comme contexte pour que tout ce qui est généré ensuite reste conforme à la marque. Elle lit également une sélection et écrit le style déjà utilisé sous la même forme structurée.

Ce que cette compétence ne fait pas : inventer des règles de marque que l'utilisateur n'a pas données, restyler des calques que l'utilisateur n'a pas sélectionnés, remplacer une bibliothèque de design publiée, ni générer des images par elle-même. Lorsqu'une bibliothèque publiée avec des composants et des variables couvre déjà le look, le dire et utiliser la bibliothèque comme source de vérité.

Quand l'utiliser

  • L'utilisateur demande que quelque chose soit conforme à la marque, cohérent ou dans une esthétique nommée.
  • L'utilisateur nomme un style, un mouvement artistique ou colle un lien styleref.io/share/....
  • L'utilisateur souhaite une palette et une échelle typographique pour démarrer et n'a pas encore de bibliothèque.
  • L'utilisateur souhaite que le look d'une trame existante soit consigné pour être réutilisé — dans ce fichier, dans un autre fichier ou dans un outil d'image IA.
  • L'utilisateur explore une expression de marque que les composants ne capturent pas encore.

Voie A — appliquer un style au fichier

Exécuter ceci lorsque l'utilisateur nomme un style ou demande un look que vous devez sourcer.

  1. Résoudre le style. Si l'utilisateur a collé un lien styleref.io/share/{slug}, en extraire le slug. Sinon effectuer une recherche :

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

    Ajouter &category={catégorie} pour affiner. Catégories valides : Brand identity, UI/UX, Graphic design, Illustration, Packaging design, Photography, Fine art, 3D visualization, Character design, Cinematography, Game art, Social copy. La réponse donne à chaque correspondance un name, slug, author, palette (liste hex) et url. Montrer à l'utilisateur 3–5 avec leurs palettes et le laisser choisir. Ne pas choisir à sa place lorsque deux candidats ont des lectures différentes.

  2. Récupérer la spécification structurée.

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

    Chaque valeur écrite sur le canvas provient de celle-ci. Récupérer également la forme en prose lorsque vous générerez des trames ou des images par la suite :

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

  3. Écrire les couleurs sous forme de variables locales. sections.colors.values.color_palette.solidColors est une liste ordonnée de {hex, amount}. amount est la part prévue de la composition — une proportion, pas un rôle sémantique. Créer une collection nommée d'après le style, et une variable de couleur par hex, ordonnée par amount décroissant. Proposer des noms de rôles (surface, accent, ink) comme suggestion et préciser qu'ils sont vôtres, pas ceux de la spécification. Appliquer également les règles de couleur non hex — saturation_range, contrast_strategy, gradient_policy, color_temperature, shadow_color — comme contraintes sur tout ce que vous dessinez ; ce ne sont pas des variables.

    Si accessibility_level est WCAG AA ou AAA, c'est une exigence, pas une préférence : vérifier les paires texte-sur-fond par rapport à ce ratio lors de leur attribution, et dire quelles paires vous avez vérifiées. Lorsqu'une paire dans la palette ne peut pas l'atteindre, le dire et proposer une correction plutôt que de livrer la paire silencieusement.

  4. Écrire la typographie sous forme de styles de texte. sections.typography.values.font_family est une catégorie ("Display / Decorative", "Geometric Sans"), jamais un nom de police sous licence. Choisir une police concrète déjà disponible dans le fichier, ou l'une des polices par défaut de Figma, et dire à l'utilisateur quelle police vous avez choisie et que la spécification a nommé une catégorie, pas cette police. Ensuite appliquer font_weights, text_case, letter_spacing et typographic_hierarchy aux styles que vous créez.

  5. Écrire la couche d'interface à partir de ui_web. C'est la section qui porte le plus de Figma en elle — trente-trois champs qui sont déjà le vocabulaire de Figma. La lire avant de dessiner une seule trame :

    • color_theme est Light ou Dark. Un StyleRef porte une palette et donc un thème — il n'y a pas de second ensemble de valeurs pour le mode opposé. Construire une collection mono-thème. Si l'utilisateur souhaite clair et foncé, dire que le style définit un thème et proposer de construire l'autre mode à partir de valeurs fournies par l'utilisateur ; ne jamais le dériver vous-même. Une palette inversée est une marque différente portant le même nom, et l'utilisateur ne peut pas le repérer ensuite.
      • Les styles plus anciens peuvent encore porter une étiquette double-thème. Faire confiance à la palette, pas à l'étiquette : juger à partir des hex elles-mêmes — celle marquée comme fond de page, ou la dominante par amount — et dire que le style est mal étiqueté.
    • background_tone → le remplissage de fond de page/canvas. surface_layers → combien de variables de surface sont nécessaires (Flat = une, Two-layer = page + carte, Three-layer = page + carte + surélevé). Ne pas inventer une quatrième.
    • accent_strategy → combien de variables d'accent, et si elles sont un accent fonctionnel unique ou un ensemble contextuel. semantic_colors → variables d'erreur / avertissement / succès / info, seulement au niveau des noms de champs.
    • elevation_approach, shadow_technique, shadow_weight, glass_blur_effect → les styles d'effet. Ceux-ci remplacent tout ce que vous avez déduit de light_shadow, qui décrit la lumière photographique, pas l'élévation UI.
    • border_philosophy → traitement de contour par défaut. button_shape et button_hierarchy → les trames de boutons et leurs variantes. icon_style et icon_weight → quel jeu d'icônes utiliser, et à quel poids.
    • navigation_pattern et navigation_style → le squelette de mise en page de l'écran, et layout_archetype dit ce qu'est réellement la trame qu'il enveloppe (Dashboard, Feed, Split-screen, Master–detail, Marketing page, Canvas, Wizard / flow). content_width définit la largeur de la trame et si le contenu est en plein écran ou contenu dans un conteneur.
    • spacing_scale et density → les nombres d'auto-layout. 4pt grid / 8pt grid est le pas dont chaque écart et valeur de remplissage est un multiple ; Compact … Spacious met à l'échelle quel multiple vous utilisez. Les construire comme variables d'espacement, pas comme des nombres tapés dans chaque trame. Là où spatial_hierarchy parle également d'espacement ou de densité, ui_web gagne — c'est l'énoncé au niveau de l'interface.
    • corner_radius_scale → variables de rayon, appliquées à l'échelle du système. button_shape l'affine pour les boutons uniquement ; Mixed by component signifie que l'échelle est délibérée par élément, donc énoncer votre correspondance plutôt que de choisir un rayon.
    • card_style → si le contenu se trouve dans des cartes ou non, et si elles sont bordées, ombrées, teintées ou en verre. input_field_style → le composant de contrôle de formulaire (Outlined, Filled / tinted, Underline only, Borderless on surface).
    • data_display_style et data_viz_style → ne les construire que lorsque le champ n'est pas None ; ils définissent la densité du tableau, les grilles de graphique, les chiffres KPI et la couleur de série. ui_imagery dit ce qui va dans les emplacements d'image — None (pure UI) signifie les omettre plutôt que de les remplir avec une photographie d'espace réservé.
    • empty_state_style → une vraie trame que vous dessinez. loading_style est un comportement : un Skeleton shimmer obtient une trame de squelette statique plus une note, jamais une fausse animation.
    • focus_ring_style est un artefact d'accessibilité, pas une décoration. Le construire, et ne jamais le supprimer pour rendre un écran plus propre.
    • hover_treatment, animation_philosophy, transition_speed et scroll_behavior décrivent un comportement, qu'une trame statique ne peut pas contenir. Les enregistrer comme notes sur le canvas ou dans votre réponse — ne pas les simuler comme des styles et ne pas les supprimer silencieusement.

    Lorsque ui_web est absent, le dire et travailler à partir des sections ci-dessous ; ne pas inventer de règles d'interface que le style n'a jamais spécifiées.

  6. Mapper les sections restantes du canvas. Seules celles-ci se traduisent en objets du fichier :

    SectionÉcrire comme
    colorsVariables de couleur + règles de remplissage
    typographyStyles de texte
    ui_webModes de variable, variables de surface/accent/sémantiques, styles d'effet, boutons, icônes, navigation, anneaux de focus — voir étape 5
    container_boundaryRemplissage de trame, traitement des coins, comportement de découpage
    shape_languageRayon de coin, décisions de géométrie
    stroke_systemPoids de contour et extrémités
    spatial_hierarchyGrille et composition — mais ui_web gagne sur l'espacement et la densité
    light_shadowStyles d'effet — mais ui_web gagne là où les deux parlent
    surface_materialTraitement de remplissage, texture
    background_environmentArrière-plans de trame
    guardrailsRègles strictes "ne jamais faire ceci" — les respecter

    mood_personality, output_format, references, inspiration_images et custom_style_items ne correspondent pas à des objets du fichier. Les conserver comme contexte pour la génération et pour vos propres jugements.

  7. Conserver la spécification comme contexte de génération. Pour toute trame, mise en page ou image que vous générez ensuite, mettre le texte format=default devant la requête comme bloc de contrainte. Le coller textuellement — il est écrit pour être appliqué, et le paraphraser fait perdre les contraintes.

  8. Attribuer le style. Laisser le nom du style, son auteur @handle et l'URL canonique styleref.io/share/... quelque part où l'utilisateur peut les voir — une note sur le canvas ou dans votre réponse. L'API renvoie cette URL avec chaque réponse.

Voie B — capturer le style déjà sur le canvas

Exécuter ceci lorsque l'utilisateur souhaite que le look d'une sélection existante soit consigné. Cela ne nécessite aucun appel réseau.

  1. Exiger une sélection. Si rien n'est sélectionné, demander à l'utilisateur de sélectionner les trames qui représentent le look. Ne pas deviner à partir de toute la page.

  2. Lire ce qui est réellement présent — les remplissages et leurs proportions approximatives, les styles de texte et leurs poids et casses, les rayons de coin, les poids de contour, les valeurs d'ombre, le rythme d'espacement, le traitement de fond.

    Si la sélection est une interface, lire également la couche d'interface, car c'est la moitié qu'une palette de couleurs seule ne portera pas : combien de niveaux de surface le design empile, si la profondeur vient de l'ombre, du flou ou du simple contraste, si les bordures sont présentes ou implicites, la forme du bouton et combien de rangs de boutons il y a, le style et le poids des icônes, le motif de navigation, et si les anneaux de focus existent. Ceux-ci deviennent la section ui-and-web. Noter ceux que vous avez cherchés et que vous n'avez pas trouvés — une interface sans état de focus visible est une constatation digne d'être rapportée, pas un blanc à ignorer.

  3. L'écrire dans la structure de section StyleRef, en utilisant uniquement les sections pour lesquelles vous avez des preuves réelles. Laisser le reste de côté ; une section vide est honnête, une section devinée ne l'est pas.

    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. Séparer ce que vous avez mesuré de ce que vous avez déduit. Les valeurs hex et les rayons sont mesurés. "Confiant, éditorial, retenu" est déduit — le marquer comme votre lecture et laisser l'utilisateur le corriger.

  5. Proposer l'étape suivante. La spécification capturée est réutilisable en dehors de ce fichier — dans un autre fichier Figma, ou comme bloc de style pour un outil d'image ou de copie IA. Diriger l'utilisateur vers https://styleref.io pour l'enregistrer en tant que véritable StyleRef, ce qui le rend également adressable par une URL plutôt que par copier-coller.

Déclarations honnêtes — ne pas enfreindre celles-ci

L'utilisateur répétera ce que vous lui dites, donc cela doit être vrai.

  • Ne jamais revendiquer une amélioration avant/après. Il n'y a pas de base de référence non stylée à comparer, et vous n'en avez pas mesuré.
  • Ne jamais revendiquer que le style produit une sortie identique ou correspondante entre différents outils d'IA. Différents modèles rendent la même spécification différemment. L'affirmation précise est qu'un style est portable — une définition, collée n'importe où — et cohérent au sein d'un seul outil, car chaque génération reçoit les mêmes contraintes explicites.
  • Ne jamais présenter une valeur déduite comme une valeur spécifiée. La police que vous avez choisie, les noms de rôles que vous avez proposés et l'ambiance que vous avez lue sur une sélection sont vôtres. Le dire.
  • Ne jamais revendiquer que le fichier correspond désormais exactement à la référence. Vous avez appliqué une spécification ; vous n'avez pas reproduit une image.
  • Ne jamais inventer une palette de contrepartie foncée (ou claire). Un style porte un ensemble de couleurs. Les inverser ou les redériver produit une marque différente portant le même nom, et c'est le genre de fabrication qu'un utilisateur ne peut pas repérer ensuite.

En cas de problème

Chacun de ces cas devrait se terminer par l'utilisateur en mesure d'agir, pas par une erreur qui lui est collée.

Ce qui s'est passéQue faire
La recherche retourne count: 0La réponse liste availableCategories. Réessayer avec une requête plus large ou une catégorie. Après deux tentatives vides, dire que la galerie n'a pas de correspondance proche et proposer la Voie B à la place.
404 not_foundLa référence était erronée. Une référence est un slug de partage ou une URL /share — jamais le nom d'un style ou @auteur/nom. Relancer la recherche pour obtenir un slug valide.
403 auth_requiredLe style est privé. Seul son propriétaire peut le lire. Demander à l'utilisateur un style public, ou le connecteur StyleRef s'il s'agit du sien.
429 rate_limited60 requêtes/minute par IP. Attendre les secondes Retry-After et réessayer une fois. Si cela persiste, demander à l'utilisateur d'ouvrir https://styleref.io/share/{slug}.md dans un navigateur et de coller le contenu — cela n'a pas de limite de débit.
Le slug de recherche existe mais pas le slug de partageLes styles brouillons dans l'éditeur styleref.io/create n'ont pas de slug de partage avant d'être publiés. Dire à l'utilisateur de publier le style via l'interface d'édition, puis de réessayer.
ui_web est manquantLe style n'a pas été écrit pour l'interface. Travailler des sections générales. Dire à l'utilisateur ce que vous avez appliqué (palette + échelle de texte) et ce qui manque.
Le chargement du fichier échoue (la lecture depuis Figma)Demander à l'utilisateur de fermer l'onglet du navigateur avec le fichier Figma ouvert et de réessayer. Un conflit de connexion se produit parfois lorsque les deux onglets sont ouverts par le même compte.
L'écriture des variables échoueLes variables locales nécessitent que le fichier soit dans un projet d'équipe (Team) ou d'organisation — les fichiers dans la section « Drafts » de Figma ne prennent pas en charge les variables. Vérifier donc si le fichier est un brouillon. Le dire à l'utilisateur et, à la place, dessiner un panneau de spécification sur le canvas avec les valeurs appliquées en remplissages et styles de texte, afin que le look soit visible même sans variables.
latent_palette_policy est Prefer analogousTraiter cela comme faisant partie de color_temperature — une contrainte de génération, pas une variable ou un style.

Quand plusieurs styles sont en jeu

Si l'utilisateur veut que deux styles vivent dans le même fichier, traiter chaque application comme un mode de variable distinct. La collection de variables reçoit un nom par style ; pour le mode, utiliser le nom du style. Ne pas fusionner les palettes — un fichier peut porter deux looks côte à côte sans les mélanger.


StyleRef est construit par @illinois — il n'y a pas de plugin, pas de connecteur, pas de paiement. Une URL de partage est tout ce dont vous avez besoin.

Skills associés