Communitygithub.com

design-ui

À charger avant de concevoir, construire ou revoir un écran ou composant d’interface, web ou mobile : disposition, espacement, typographie, couleur, ombres, boutons, formulaires, cartes, icônes, navigation, images, texte, animations, accessibilité, états vides/erreur. Les règles que tout écran suit sont ici, avec un fichier de référence par sujet : lisez uniquement ceux que la tâche aborde.

Qu'est-ce que design-ui ?

Ce skill définit un ensemble de règles compactes et actionnables pour la conception d’interfaces utilisateur, inspirées du livre *UI Design Principles* de Michael Filipiuk (édition 2021). Il sert de guide pour tout développeur ou designer qui crée ou révise un écran ou un composant, en fournissant des principes clairs sur la disposition, l’espacement, la typographie, la couleur, les ombres, les boutons, les formulaires, les cartes, les icônes, la navigation, l’imagerie, le contenu textuel, l’animation, l’accessibilité et les états d’écran (vides, chargement, erreur). Le système s’applique aussi bien au web qu’au mobile, et s’intègre avec les systèmes de design existants du dépôt (Tailwind, shadcn, MUI, CSS variables). Il utilise une échelle d’espacement de 4 pt sur mobile et 8 pt sur web, une taille de corps de 16-17 px, un contraste minimum de 4,5:1 pour le texte, et des cibles tactiles d’au moins 44×44 px. Chaque sujet dispose d’un fichier de référence dédié dans le dossier `references/` ; le développeur ne lit que les fichiers pertinents pour sa tâche. Le skill priorise la convivialité, l’accessibilité, la cohérence, la simplicité et l’esthétique, dans cet ordre, et n’introduit jamais de second jeu de tokens à côté de celui du dépôt.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanEliasJabib02/ui-design-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

Conception UI : règles pour construire des interfaces

Ces règles sont extraites de UI Design Principles par Michael Filipiuk (édition 2021). Ce fichier contient les règles qui s’appliquent à chaque écran. references/ (à côté de ce fichier) contient le détail, un fichier par sujet ; lisez uniquement les fichiers que votre tâche aborde.

Les règles sans balise proviennent du livre. (WCAG) marque une norme d’accessibilité que le livre ne mentionne pas. (convention) marque une valeur industrielle courante ajoutée pour combler un vide. (dérivé) marque une valeur calculée avec la méthode du livre. 1 pt dans le livre = 1 px CSS = 1 pt iOS = 1 dp Android.

Le système de design du dépôt prime

Si le dépôt possède déjà des tokens ou un thème (une config Tailwind, des variables CSS, un thème shadcn/MUI, une bibliothèque components/ui/), utilisez-les. Ce skill ne fait que compléter ce qu’ils ne définissent pas.

  • N’introduisez jamais un second jeu de tokens à côté de celui du dépôt.
  • Réutilisez un composant existant plutôt que d’en construire un parallèle.
  • Lorsque le dépôt lui-même enfreint l’une des règles ci-dessous (un contraste insuffisant, un bouton de 32 px), conservez la valeur du dépôt et signalez le conflit. Ne passez pas outre en silence.

Priorité en cas de conflit de règles : utilisabilité > accessibilité > cohérence > simplicité > aspect visuel.

Parcours rapide

  1. Personnalité d’abord : ludique, neutre ou sérieuse, selon la marque et le public (references/personnalite-et-texte.md). Jamais votre propre goût.
  2. Les tokens avant les écrans : couleurs, échelle typographique et échelle d’espacement, depuis le dépôt ou references/tokens.md. N’utilisez rien en dehors.
  3. Nuances de gris d’abord : obtenez la hiérarchie, la disposition et l’espacement corrects, puis ajoutez de la couleur uniquement là où elle a un rôle.
  4. Composants avec tous les états (défaut, survol, enfoncé, focus, désactivé, erreur, succès), et tous les états d’écran (vide, chargement, erreur, 404).
  5. Avant de signaler comme terminé : parcourez references/liste-de-verification.md pour ce que vous avez construit. Si vous pouvez en faire une capture d’écran, vérifiez la capture, pas le code.

Non-négociables

  1. L’espacement provient de l’échelle. Utilisez une échelle de 4 pt sur mobile et de 8 pt sur le web. Pas de valeurs 5, 13 ou 22 px.
  2. Le texte du corps fait 16–17 px. Ne descendez jamais en dessous de 10 px pour un texte quelconque, et préférez 12 px ou plus. N’utilisez jamais de graisse Fine (Light) pour les petits textes.
  3. Une seule police de caractères, par défaut un sans serif. Utilisez environ 5 tailles.
  4. N’utilisez jamais #000000 pour du texte ou des ombres. Utilisez un gris foncé teinté comme #1F1F1F.
  5. Une seule couleur primaire, appliquée uniquement à ce qui doit se démarquer. Si tout se démarque, rien ne se démarque.
  6. Contraste : 4,5:1 pour le texte du corps, et 3:1 pour les grands textes et les éléments d’interface (WCAG).
  7. N’utilisez jamais la couleur seule pour transmettre un sens. Les messages d’erreur, les messages de succès et les liens reçoivent également une icône, du texte, une graisse ou un soulignement.
  8. Chaque cible tactile fait au moins 44×44, même lorsque le glyphe visible est plus petit.
  9. Les boutons font 40–60 px de haut, avec un bouton principal par groupe. Lorsque les boutons sont en paire, le principal se trouve à droite. Le libellé indique exactement ce qui se passe.
  10. Les champs de saisie ont toujours un libellé visible. Un placeholder seul n’est pas un libellé. Utilisez un formulaire à une seule colonne avec validation en ligne, et n’effacez jamais ce que l’utilisateur a saisi.
  11. Les ombres sont douces (grand décalage Y, grand flou, opacité 5–10 %), et uniquement sur les éléments interactifs ou surélevés.
  12. Les icônes proviennent d’un seul pack, dans un seul style, avec la même épaisseur de trait et la même rondeur. Les icônes qui ne sont pas universellement connues reçoivent un libellé.
  13. Les animations donnent un retour, durent moins de 1000 ms et sont atténuées (jamais linéaires).
  14. Pas de Lorem Ipsum. Écrivez un texte réel, court et humain. Les erreurs indiquent comment résoudre le problème. Les boîtes de dialogue nomment l’objet et la conséquence.
  15. Même chose, même apparence, même comportement d’un écran à l’autre. Suivez les motifs de la plateforme pour le comportement.

Quelle référence lire

La tâche abordeLire
Un nouveau projet ou thème, choix des valeurstokens.md (espacement, échelle typographique, rôles de couleurs, rayon, ombre, mouvement, CSS de démarrage)
Une page ou une disposition d’écran, grille, espacement, hiérarchielayout.md
Styles de texte, titres, paragraphestypographie.md
Palette, mode sombre, ombres, dégradéscouleur-et-profondeur.md
Boutons et appels à l’actionboutons.md
Formulaires, champs de saisie, sélecteurs, cases à cocher, validationformulaires.md
Cartes, listes d’élémentscartes.md
Icônesicones.md
Barre d’onglets, navigation supérieure, barre latérale, liensnavigation.md
Photos, illustrations, illustration d’état vide et 404imagerie.md
Ton de la marque, libellés de boutons, boîtes de dialogue, erreurs, tonpersonnalite-et-texte.md
Transitions, survol, chargement, retourmouvement.md
Contraste, texte alternatif, cibles, légendesaccessibilite.md
Composants à réutiliser, états, écrans vides/404, système de designsysteme-et-etats.md
Relecture d’un écran terminéliste-de-verification.md

Tous les chemins se trouvent sous le dossier references/ de ce skill.

Skills associés