Communitygithub.com

visual-design

À utiliser lors de la construction ou de la modification d'un système de design, comme les jetons de conception, la palette de couleurs, le contraste, les polices, l'échelle typographique, l'échelle d'espacement, le mode sombre, les jetons d'animation ou les spécifications d'état des composants. Ne pas utiliser pour la mise en page ou la critique d'une page spécifique ou d'une refonte ; utilisez `designer`. Ne pas utiliser pour créer des images ; utilisez `artiste`.

Qu'est-ce que visual-design ?

Cette compétence (skill) guide la création et la maintenance d'un système de design cohérent et évolutif, en se concentrant sur les fondations sous-jacentes : jetons de couleur, typographie, espacement, formes, profondeur et animation. Elle fournit des règles strictes pour garantir la cohérence, l'accessibilité (conformité WCAG 2.2) et la maintenabilité, comme l'utilisation de jetons sémantiques plutôt que de valeurs brutes, la vérification du contraste pour chaque paire réelle (y compris en mode sombre), et la spécification de tous les états des composants. Utile pour les ingénieurs et designers travaillant avec des plateformes comme Claude Code, Cursor ou Codex, cette compétence détaille l'ordre de construction (de la direction de conception aux spécifications des composants), les pièges courants (comme les échelles mal nommées ou les jetons primitifs dans les composants) et les vérifications finales. Elle complète les compétences `designer` (mise en page de pages spécifiques) et `artiste` (génération d'images), et s'appuie sur des références externes pour les graphiques (`frontend`) et les détails du mode sombre.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heliacon/claude-skills/tree/HEAD/skills/visual-design

Demander à votre IA préférée

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

Documentation

Conception visuelle

Le système sous-jacent à chaque écran : jetons pour la couleur, la typographie, l'espace, la forme, la profondeur et l'animation, ainsi que les spécifications des composants qui en découlent. La compétence designer applique ce système à des pages réelles. Construisez le système une fois ; laissez les pages le dépenser.

Les règles les plus importantes

  1. Rédigez la direction de conception en mots avant tout jeton. Trois ou quatre phrases : à qui elle s'adresse, ce qu'elle doit ressentir, ce qu'elle ne doit jamais ressentir, et la seule chose qu'elle emprunte au sujet. Chaque décision de jeton est vérifiée par rapport à ce paragraphe.
  2. Les composants référencent des jetons sémantiques, jamais des primitives. --color-text-primary, pas --grey-900. Le mode sombre, le thème et les changements de marque deviennent alors une remise en correspondance, pas une réécriture.
  3. Vérifiez le contraste pour chaque paire réelle, dans les deux thèmes, par rapport au tableau ci-dessous. Une palette qui passe sur du blanc peut échouer sur sa propre surface teintée.
  4. Une valeur par défaut n'est pas une décision. Les gris du framework, Inter partout, un rayon de 4 px sur chaque boîte : chacun semble correct et ensemble, ils ressemblent à tous les autres produits. Décidez chaque valeur ou acceptez-la en connaissance de cause.
  5. Chaque spécification de composant énumère tous ses états : défaut, survol, focus, actif, désactivé, chargement, erreur et sélectionné le cas échéant. Les états manquants sont inventés lors de la construction, de manière incohérente.
  6. Moins de valeurs, utilisées de manière cohérente. Une échelle de 6 niveaux utilisée partout bat une échelle de 14 niveaux utilisée au hasard.

Quand ne pas l'utiliser

  • Organiser une page spécifique, choisir ce qui se trouve au-dessus de la ligne de flottaison, critiquer un écran ou mener une refonte : designer.
  • Générer des illustrations, des icônes, des images de héros ou des marques : artiste.
  • Graphiques et palettes de visualisation de données : la compétence frontend references/charts.md. Les couleurs catégorielles des graphiques ont des contraintes qu'une palette de marque n'a pas.
  • Implémenter les jetons dans un framework : frontend.

Ordre de construction

Chaque couche dépend de la précédente :

  1. Paragraphe de direction.
  2. Couleur : primitives, puis jetons sémantiques.
  3. Typographie : polices, puis échelle et rôles.
  4. Échelle d'espacement et grille.
  5. Rayon, bordure et élévation.
  6. Jetons d'animation.
  7. Jetons de composants et spécifications de composants.

Couleur

Structure :

Primitives (valeurs brutes, une rampe par teinte, par exemple 50, 100 ... 900, 950) :
  --blue-600: oklch(0.55 0.17 255)

Jetons sémantiques (référencent les primitives, nommés par fonction) :
  --color-bg, --color-surface, --color-surface-raised
  --color-text, --color-text-muted, --color-text-on-accent
  --color-accent, --color-accent-hover
  --color-border, --color-focus-ring
  --color-danger, --color-success, --color-warning (chacun avec une variante sûre pour le texte)

Règles qui distinguent une palette réfléchie d'une palette par défaut :

  • Construisez les rampes en OKLCH. La luminosité reste perceptuellement uniforme entre les teintes, donc un bleu 600 et un vert 600 ont le même poids visuel. La luminosité HSL ment.
  • Teintez les neutres. Le gris pur et le noir ou blanc pur semblent sans propriétaire. Ajoutez une petite quantité de chroma (environ 0,005 à 0,015) vers la teinte de la marque.
  • Le texte sur une surface colorée utilise une nuance foncée de la teinte de cette surface, pas du gris neutre. Le gris sur la couleur semble délavé.
  • Choisissez un niveau d'engagement et tenez-le : retenu (fond neutre, un accent), engagé (teinte de marque présente partout), palette complète, ou saturé (la teinte de marque est le fond). Un demi-engagement ressemble à de l'indécision.
  • Ne laissez jamais la couleur porter seule le sens. Associez-la à une icône, une étiquette ou un motif.
  • Méfiez-vous des réflexes courants. Une page crème chaleureuse avec une police d'affichage à empattements et un accent terre cuite, ou un noir presque pur avec un accent acide, sont ce que les designers atteignent par réflexe quand rien n'a été décidé. Utilisez-les uniquement lorsque le paragraphe de direction le demande.

Contraste (WCAG 2.2)

PaireAAAAA
Texte du corps (en dessous de la grande taille)4,5:17:1
Texte large : 24 px standard, ou environ 18,7 px en gras, et plus3:14,5:1
Limites des composants d'interface, icônes, indicateurs de focus, marques de graphiques qui portent du sens3:1aucune
  • Le texte indicatif qui communique quelque chose à l'utilisateur est du texte : 4,5:1.
  • Les contrôles désactivés sont exemptés, mais l'utilisateur doit toujours voir qu'un contrôle est présent.
  • Mesurez les couleurs calculées, y compris l'opacité et les superpositions. Une étiquette à 60 % d'opacité sur une carte teintée est une nouvelle couleur.

Typographie

  • Choisissez les polices pour le registre du contenu, pas par habitude. Trois rôles : une police d'affichage avec du caractère, utilisée avec parcimonie ; une police de corps confortable ; une police utilitaire pour les étiquettes, les légendes et les données (chiffres tabulaires pour les nombres dans les tableaux).
  • Associez sur un contraste clair (empattement avec sans-empattement, géométrique avec humaniste) ou utilisez une seule famille sur plusieurs graisses. Deux polices similaires mais pas identiques ressemblent à une erreur.
  • Échelle modulaire. Choisissez un ratio : 1,2 pour une interface produit dense, 1,25 à 1,333 pour le contenu et le marketing. Nommez les rôles, pas les tailles : display, h1 à h4, body-lg, body, body-sm, label, caption.
  • Mesure 60 à 75 caractères pour le texte du corps (max-width: 70ch).
  • Le texte d'affichage bénéficie d'un crénage plus serré (environ -0.02em à -0.04em) et d'un plafond de taille (environ 6 rem via clamp()). Plus grand semble rarement intentionnel.
  • text-wrap: balance sur les titres, text-wrap: pretty sur la prose du corps.
  • Hauteur de ligne : environ 1,5 pour le corps, 1,1 à 1,25 pour l'affichage.

Espace, forme, profondeur

  • Échelle d'espacement sur une base de 4 ou 8 : par exemple 4, 8, 12, 16, 24, 32, 48, 64. Les composants utilisent des jetons, jamais de valeurs brutes en pixels.
  • Rayon : deux ou trois valeurs avec une règle pour savoir où chacune s'applique. Rayons imbriqués : le rayon intérieur est égal au rayon extérieur moins le rembourrage entre eux.
  • Élévation : trois ou quatre niveaux, chacun lié à une fonction (carte au repos, menu déroulant, modale). Dans les thèmes sombres, augmentez l'élévation avec une surface plus claire, pas une ombre plus lourde.

Animation

  • Jetons : durées (par exemple 120ms, 200ms, 320ms) et deux ou trois courbes d'assouplissement (une pour l'entrée, une plus marquée pour la sortie). Les éléments les réutilisent ; personne ne choisit une valeur par élément.
  • L'animation explique un changement : d'où vient quelque chose, ce qui a réagi. Une animation qui ne fait que décorer semble générée.
  • Un moment chorégraphié bat tout ce qui apparaît en fondu en même temps.
  • Respectez prefers-reduced-motion: reduce : supprimez le mouvement et les transitions longues, conservez les changements d'opacité.
  • Ne zoomez pas les photos au survol. Animez le conteneur (ombre, bordure, fond).

Mode sombre

  • Un thème sombre est une remise en correspondance des jetons sémantiques, jamais une inversion. Utilisez des gris foncés pour le fond, pas du noir pur, et réduisez le chroma des accents qui brillent.
  • Re-vérifiez chaque paire de contraste dans le thème sombre.
  • Évitez le flash du mauvais thème : décidez le thème dans un petit script en ligne dans l'en-tête du document, avant la première peinture.

Consultez references/dark-mode.md lors de l'implémentation du changement de thème, de la persistance ou des images en mode sombre.

Spécifications des composants

Consultez references/component-spec.md avant d'écrire une spécification de composant. Il contient le modèle et la liste de contrôle des états.

Pièges

  • 11 nuances nommées 100 à 900. Cela fait 9 étapes. Nommez les rampes pour que le nombre et les noms correspondent (50, 100 ... 900, 950 donne 11).
  • "Texte large" signifie 18 points, pas 18 pixels. Un texte de corps de 18 px standard nécessite 4,5:1, pas 3:1. Le seuil de texte large est de 24 px standard ou environ 18,7 px en gras.
  • Jetons primitifs dans les composants. Fonctionne jusqu'au premier thème. Ensuite, chaque composant nécessite une modification.
  • Contraste vérifié sur la maquette, pas sur la version construite. L'opacité, les superpositions et l'anti-crénelage modifient la couleur réelle. Mesurez les pixels rendus ou les styles calculés.
  • Un ajustement global pour résoudre un problème local. Assombrir toute la palette pour sauver une paire défaillante modifie toutes les autres paires. Corrigez le jeton de la paire.
  • Un jeton que personne n'utilise, ou une valeur brute que personne n'a tokenisée. Les deux signifient que le système et la version construite ont dérivé. Recherchez les valeurs hexadécimales brutes et les valeurs de pixels dans la version construite.
  • Une nouvelle police chargée pour un seul titre. Chaque police coûte du temps de chargement. Utilisez les polices que le système charge déjà.

Vérification

  • Paragraphe de direction rédigé, et chaque famille de jetons peut y être rattachée.
  • Chaque paire de texte et d'interface passe AA en mode clair et sombre, mesurée sur la page construite.
  • Les composants utilisent uniquement des jetons sémantiques : la recherche montre aucune valeur de couleur ou d'espacement brute dans le code des composants.
  • Chaque spécification de composant énumère tous ses états.
  • Paramètre de mouvement réduit testé : aucun mouvement ne reste.
  • Le changement de thème n'affiche aucun flash lors d'un rechargement forcé avec le paramètre système opposé.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

api-design

Use when designing or changing an HTTP API contract, adding or editing a route, endpoint or webhook, writing an OpenAPI spec, choosing error, pagination or versioning shapes. Also when asking "is this a breaking change". Not for server internals such as jobs, retries or rate-limit storage; use `backend-patterns`.

artist

Use when making or directing visual assets such as illustrations, hero images, icons, logos, brand marks, textures or diagrams, or writing prompts for an image-generation model. Covers art direction, reference boards and critique against a brief. Not for page layout; use `designer`. Not for palettes and tokens; use `visual-design`.

copywriter

Use when writing, rewriting or reviewing words a customer reads, such as landing or marketing pages, headlines, taglines, calls to action, pricing pages, product descriptions, onboarding text, button labels, error messages and empty states. Not for long-form docs or articles; use `docs`. Not for positioning strategy; use `marketing`.

designer

Use when asked to critique, redesign or review the layout and hierarchy of a page, screen, landing page or dashboard (hero, CTAs, card grids, testimonials), or when a design \"looks off\", \"looks generic\" or \"looks AI-made\". Use it for any layout feedback, even if the word design is not used. Not for tokens, palettes or type scales; use `visual-design`. Not for images; use `artist`.

frontend

Use when building, reviewing or fixing browser UI, such as pages, components, forms, client state, charts, print or PDF views, accessibility or web performance (Core Web Vitals, bundle size, slow renders). Not for visual direction, layout critique or brand (use `designer` or `visual-design`). Not for native or React Native apps (use `mobile`).

game-design

Use when designing or reviewing how a game plays: core loop, mechanics, game feel and juice, difficulty curve, progression, economy and balance, tutorials, HUD and menus or a game design document (GDD) and playtest plan. Not for engine code or rendering (use `frontend`) or for non-game product UX (use `ux-research`).

ux-research

Use when planning or synthesising user research (interviews, usability tests, surveys), mapping a journey or job to be done, specifying an interaction's states, or running a heuristic review of a flow. Not for menus, labels, taxonomy or site structure; use `information-architecture`. Not for visual polish; use `designer`.

Skills associés