Communitygithub.com

21 Grams UI – Polissage d'interface

Peaufine une interface existante pour qu'elle cesse de ressembler à une création IA, en appliquant des règles d'UX, d'animation et de motion via les composants et jetons de design du projet.

Qu'est-ce que 21 Grams UI – Polissage d'interface ?

Cette compétence, nommée « 21 Grams UI », permet d'auditer et d'améliorer une interface utilisateur déjà existante afin d'éliminer les signes typiques d'une conception générée par IA (mélange de styles d'icônes, rayons incohérents, animations maladroites, manque de hiérarchie visuelle). Son principe fondamental est de n'utiliser que les composants, les jetons de design (variables CSS, thèmes, configuration Tailwind) et la bibliothèque d'icônes déjà présents dans le projet, sans jamais ajouter de dépendance externe ou créer un kit parallèle. Elle s'appuie sur un ensemble structuré de règles maison (typographie, espacement, couleurs, motion, copie), 20 principes d'UX et d'animation (lois de Fitts, Hick, Miller, Doherty, Postel, Jakob), 10 astuces de design CSS (rayon concentrique, bordures alpha, OKLCH, dvh), 10 subtilités typographiques et 20 techniques d'animation (easing directionnel, stagger, press scale, layout transitions). Le workflow commence par un inventaire du système de design, suivi d'un audit détaillé (fichier par fichier, ligne par ligne) présenté à l'utilisateur avant toute modification massive. Les corrections sont appliquées dans l'ordre : jetons → composants partagés → écrans, avec vérification dans le navigateur (contrastes, états au survol, press, focus, mode sombre, reduced motion). La compétence génère un rapport final listant chaque changement par règle, principe, astuce et technique, garantissant une interface cohérente, rapide et appartenant toujours au produit d'origine.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilbognov/21grams/tree/HEAD/skills/ui

Demander à votre IA préférée

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

Documentation

21 Grams UI – Polissage d'interface (UI Uplift)

Une passe sur une interface utilisateur qui existe déjà. 21 Grams UI (le package UI de la famille 21 Grams) ne refait pas le design du produit et n'apporte pas son propre kit UI. Il supprime les signes d'une interface construite par IA et applique un ensemble fixe de règles via les composants et les jetons que le projet possède déjà, afin que le résultat paraisse réfléchi, rapide et reste ancré dans le produit.

Règle zéro : utiliser les composants du projet

Chaque modification passe par ce que le projet utilise déjà. 21 Grams UI ne crée jamais un jeu de composants parallèle.

  1. Faire un inventaire avant de toucher à quoi que ce soit. Noter les jetons de design ou le thème (variables CSS, config Tailwind, fichiers de thème), la bibliothèque de composants (shadcn/ui, Radix, MUI, Chakra, un kit maison, un système de design client), le jeu d'icônes, la bibliothèque de graphiques et la bibliothèque d'animation. Enregistrer comment chaque composant partagé est nommé et où il se trouve.
  2. Corriger les choses là où elles vivent. Une règle concernant un bouton va dans le Button du projet (un jeton, une variante, une propriété ou ses styles), jamais dans une copie isolée sur un seul écran. Une règle de couleur ou de rayon va dans le jeton, pas dans des valeurs codées en dur.
  3. Ne jamais ajouter un composant quand un existe déjà pour le travail, et ne jamais ajouter de dépendance (kit UI, jeu d'icônes, bibliothèque de graphiques ou d'animation) pour obtenir un effet 21 Grams UI. Utiliser ce qui est installé. Sans bibliothèque d'animation, utiliser les transitions CSS.
  4. Quand une pièce manque vraiment (pas de contrôle segmenté, pas d'interrupteur), la construire à partir des primitives et des jetons existants du projet, en suivant sa structure de fichiers et sa nomenclature. Le mentionner dans le rapport.
  5. Les valeurs du style maison sont des valeurs par défaut pour les lacunes uniquement. rules/ et tokens/tokens.css donnent des valeurs pour ce que le projet n'a pas décidé. Les mapper sur les jetons du projet. Ne jamais coller tokens.css à côté d'un système existant.
  6. La marque reste celle du projet. Les couleurs de marque, les polices, les logos, le style d'icônes et la voix ne sont jamais remplacés. 21 Grams UI change comment ils sont utilisés (contraste, hiérarchie, espacement, mouvement), pas ce qu'ils sont.

Priorité : les mots de l'utilisateur, puis le système de design et la marque du projet, puis le style maison 21 Grams UI. Les principes, astuces et techniques d'animation s'appliquent partout, exprimés dans les composants du projet.

Ce qu'il contient

  1. Style maison. Huit domaines dans rules/ : radius.md (12/8/4 emboîté), buttons.md (36px, pression .97), motion.md (fluide, depuis le déclencheur, sans rebond), type.md (serré, peu de tailles), spacing.md (échelle 4pt groupée), colour.md (un accent, AA), elevation.md (remplissages tonaux), copy.md (sobre et utile). Plus trois fichiers composants : icons.md (un seul style, line, solid ou duotone, jamais mélangé), charts.md (ligne, colonne et barres horizontales) et toggles.md (interrupteur et contrôle segmenté). Les valeurs par défaut sont dans tokens/tokens.css.
  2. Les 20 principes. Principes d'UX et d'animation dans references/principles.md.
  3. Les 10 astuces de design. Détails d'artisanat CSS dans references/design-hacks.md.
  4. Les 20 techniques d'animation. Règles de mouvement au niveau implémentation (origines, durées, décalage, pression, glisser, mise en page partagée) dans references/animation-craft.md.
  5. Les 10 astuces typographiques. Largeur grasse réservée, trim de boîte de texte, décalage de soulignement, espacement d'exposant, affichage fluide, petites majuscules pour acronymes, guillemets courbes, troncature médiane, césure automatique et titres limités en lignes, dans references/typography.md.
  6. Les 20 règles anti-débraillé. Indices de composition et de contenu (badges de remplissage, étiquettes redondantes, italiques aléatoires, mono décoratif, illustration abstraite, fonctionnalités de poids égal, titres vagues, lueurs, alignement optique, états de chargement) dans references/unslop.md.

Si une compétence de visualisation de données est installée, la charger également dès qu'un graphique est impliqué.

Flux de travail

  1. Faire l'inventaire (règle zéro). Si le projet n'a aucun système de design, le dire et utiliser les valeurs par défaut du style maison.
  2. Auditer avant de changer quoi que ce soit. Parcourir l'écran ou le composant et lister les constats regroupés par domaine (radius … copie), numéro de principe, numéro d'astuce et numéro de technique. Utiliser les listes de vérification à la fin de references/principles.md, references/design-hacks.md, references/animation-craft.md, references/typography.md, references/unslop.md et rules/icons.md. Chaque constat obtient le fichier et la ligne, ce qui ne va pas, la correction et dans quel composant ou jeton existant la correction va. Signaler chaque endroit où une règle 21 Grams UI entre en conflit avec le système de design du projet, pour que l'utilisateur décide qui l'emporte.
  3. Montrer l'audit à l'utilisateur sous forme d'une courte liste et demander avant d'appliquer des changements larges. Les petites corrections évidentes dans le périmètre demandé peuvent être appliquées directement.
  4. Appliquer les corrections dans cet ordre : jetons → composants partagés → écrans. Maintenir les diffs limités à ce qui a été audité et dans les conventions du projet (formatage, lint, nommage).
  5. Vérifier dans le navigateur. Captures d'écran avant et après de chaque écran modifié. Vérifier les états survol, pression, focus, chargement, erreur, les deux thèmes et le mouvement réduit. Mesurer le contraste des boutons et du texte ; ne pas se fier à l'œil. Pour le mouvement, enregistrer l'avant et l'après si possible. Une page avant/après avec un séparateur glissable et des interactions fonctionnelles des deux côtés est la manière la plus claire de réviser un polissage.
  6. Rapporter ce qui a changé par domaine, principe, astuce et technique, quels composants et jetons ont été touchés, et tout ce qui est resté non fait.

Style maison en un coup d'œil (valeurs par défaut pour les lacunes)

  • Rayon 12 conteneurs / 8 contrôles / 4 petites pièces, emboîté comme extérieur − remplissage. Pas de pilules sauf tags et toggles.
  • Boutons 36px (32 compact, 40 important), rayon 8, 14/500, un primaire solide, un primaire par vue, survol = changement de couleur uniquement, pression = changement de couleur + scale(.97) 150ms, chargement conserve la largeur.
  • Mouvement : pas de rebond sur l'interface quotidienne. Menus 220ms entrée / 175ms sortie depuis scale(.95) au déclencheur, panneaux 240 / 190, entrées avec ease-out, sorties avec ease-in (~80% de l'entrée), lignes de liste décalées de 30ms, interactions fréquentes instantanées.
  • Typographie : les polices du projet (Geist quand il n'y en a pas). Mono est réservé au code, jamais pour les étiquettes, les surtitres, les badges, les horodatages ou les chiffres (tabular-nums dans le sans aligne les figures). Tailles 12/14/16/22/28, graisses 400/500/600, en-têtes −0.022em, au plus quatre tailles par écran. Sur mobile, les titres montent d'un cran : section 18, carte 16.
  • Bouton d'envoi sur chat mobile : un bouton icône seule 44×44 en forme d'avion en papier avec aria-label="Send".
  • Espacement : échelle 4pt. Plus serré à l'intérieur des groupes qu'entre eux (4 / 6 / 16 / 24–32 / 48). Chevron de sélection à 12px du bord droit, padding-right 36px.
  • Couleur : un accent (actions, focus, sélection), couleurs de statut séparées, texte des boutons ≥ 4.5:1 dans les deux thèmes avec --on-accent par thème.
  • Élévation : les surfaces au repos sont un pas de remplissage sans bordure ni ombre. Seules les couches flottantes obtiennent un anneau et une ombre. Le mode sombre est plus clair par couche.
  • Icônes : un seul style par produit, line, solid ou duotone, et jamais mélangé dans un menu, une navigation, une barre d'outils, une liste ou une carte. Les états sélectionnés changent la couleur, pas le style de l'icône. Une seule bibliothèque d'icônes, une seule largeur de trait, une seule taille par groupe.
  • Copie : boutons verbe + objet, erreurs avec cause et correction, casse de phrase, pas d'emoji, pas de mots accrocheurs.

Non-négociables (issus des 20 principes)

  • Un mouvement d'interface déclenché par l'utilisateur dure 120–300ms, et les sorties sont environ 80% de l'entrée. Jamais de linear pour un déplacement.
  • L'easing correspond à la direction : entrée ease-out, sortie ease-in, A→B à l'écran ease-in-out. Pas de dépassement sur l'interface quotidienne.
  • Les interactions à haute fréquence (navigation clavier, surlignage de liste, onglets dans les outils) sont instantanées.
  • Chaque entrée est reconnue en moins de 100ms. Utiliser une UI optimiste pour les sauvegardes. Montrer une progression au-delà de 400ms.
  • Les zones de clic font au moins 44×44 sur tactile et 32×32 sur bureau dense, même si l'icône est plus petite.
  • Une seule action au focus et une seule action principale par vue. Assombrir le contexte quand quelque chose prend le focus.
  • Les longs nombres sont groupés. Les champs de saisie acceptent les formats désordonnés et renvoient la valeur nettoyée.
  • Emplacement et icônes standard sauf s'il y a une raison de faire autrement.
  • Chaque état d'un composant est conçu : inactif, survol, pressé, chargement, succès, erreur, désactivé.
  • prefers-reduced-motion : supprimer le mouvement, le scale et le dépassement, conserver un bref changement d'opacité.

Non-négociables (issus des 10 astuces)

  • Rayon emboîté : intérieur = extérieur − remplissage.
  • Les bordures sont alpha (rgb(0 0 0 / .12)), jamais un hexagone gris uni sur des surfaces variées.
  • Palettes et dégradés en OKLCH (in oklch sur les dégradés).
  • L'épaisseur de trait des icônes correspond à la graisse du texte adjacent.
  • Les défileurs horizontaux s'estompent sur les bords avec un masque.
  • Les changements d'icônes se fondent avec filter: blur(4px).
  • Mode sombre : chaque couche plus haute est plus claire (page < carte < menu).
  • Pleine hauteur mobile : dvh/svh, jamais 100vh nu.
  • Photos de produit sur fond blanc sur cartes teintées : mix-blend-mode: multiply.

Non-négociables (issus des 10 astuces typographiques)

  • Le passage en gras au survol ou à la sélection ne décale jamais la mise en page (réserver la largeur du gras).
  • Les étiquettes sur une seule ligne dans les boutons et badges sont centrées optiquement (text-box-trim).
  • Les soulignements de liens évitent les jambages descendants (text-underline-offset: 0.2em). Les exposants ne cassent pas le rythme des lignes.
  • Ponctuation réelle dans la copie : guillemets courbes, apostrophes, tirets en-demi, ….
  • Les noms qui diffèrent à la fin sont tronqués au milieu. Les titres de cartes dans les grilles sont limités au même nombre de lignes.

Non-négociables (issus des 20 techniques d'animation)

  • Les popovers et menus sortent de leur déclencheur (transform-origin au déclencheur), commencent à scale(.95), jamais scale(0), et sortent en retournant dans le déclencheur.
  • Les anciens et nouveaux états se chevauchent. Il n'y a jamais d'image vide entre Enregistrer et Enregistré.
  • Les glissements suivent le pointeur 1:1 sans transition pendant le maintien, et s'étirent au-delà des limites.
  • Carte → détail étend le même élément (layoutId / transition de vue partagé), jamais un remplacement déconnecté.
  • Les contrôles segmentés et les onglets révèlent l'étiquette active avec un masque qui se déplace avec l'indicateur.
  • Les boutons mobiles s'étirent d'environ 12% (préservant la surface). Le succès obtient une pulsation.

Signes IA à éliminer

Styles d'icônes mélangés (une maison solide à côté d'un dossier contour, une icône contour qui devient solide à la sélection), deux bibliothèques d'icônes sur un même écran, emoji utilisé comme icône, badges "NOUVEAU" de remplissage au-dessus des titres, surtitres qui répètent le titre, un mot en italique ou en mono aléatoire dans un titre, étiquettes en mono, surtitres, badges, horodatages ou chiffres (mono majuscule "tech" comme // 01 STATUT), orbes 3D brillants à la place du vrai produit, rangées de cartes de fonctionnalités égales, titres "X, rencontre Y.", bordures de dégradé lumineuses, dégradés indigo vers violet, texte en dégradé, ombres colorées brillantes, le même rayon de 16px partout (rayon intérieur égal au rayon extérieur), boutons en pilule à côté d'entrées arrondies, agrandissement au survol sur les cartes et boutons, ease-in-out 300ms partout, fondu vers le haut au chargement de page, p-6 gap-6 uniforme, cartes dans les cartes, ombre plus bordure plus rayon sur chaque bloc, gris-500 pour tout texte secondaire, emoji dans les titres, et copie comme "Débloquez", "Boostez", "Sans couture" ou "Oups !".

Crédits

Les principes, astuces et techniques d'animation sont paraphrasés et étendus à partir de cinq vidéos courtes de design : "20 Principles of UX & Animation", "10 Niche Design Hacks", "20 Ways to Make Beautiful AI Animations", "10 Niche Typography Hacks" et "20 Ways to Unslop AI Designs". Voir le README pour les crédits.

Skills associés