Communitygithub.com

do-design

Conception UI et design visuel avec un DESIGN.md contraignant, et des scripts pour tout ce qui est mesurable. Utiliser pour concevoir ou restyler des pages et composants, auditer et évaluer une UI, refondre un site, rechercher un marché avant de concevoir, pousser une direction audacieuse, ou installer une garde-fou de design dans un dépôt.

Qu'est-ce que do-design ?

do-design est un skill d'agent IA spécialisé dans la conception et l'audit d'interfaces utilisateur (UI) et de design visuel, contraint par un document DESIGN.md faisant autorité. Il fournit un ensemble de commandes (do-design-review, do-audit, do-design-new, do-design-renew, do-crazy) et de scripts Python mesurables (contraste, score, rendu, etc.) qui permettent de vérifier objectivement la conformité au design, la qualité, et l'accessibilité. Le skill s'appuie sur une méthodologie rigoureuse : règles avec justification, preuves avant les suppositions, chargement paresseux des fichiers, et un système de notation pondéré (0-4) sur 7 champs (Hiérarchie, Lisibilité, Système, …). Il supporte des modes d'interaction distincts (Persuader, Opérer, Lire, Expérience) qui influencent le niveau de liberté stylistique. Les résultats d'audit sont formatés avec sévérité (P0, P1, P2, P3) et incluent des métriques comme le score global, les bandes (Fort, Solide, Faible, Échec), et une liste de travail sur les trois pires champs. Les scripts sont conçus pour être exécutés avant toute analyse, et leurs résultats doivent être cités sans réinterprétation. Le skill est particulièrement adapté aux environnements de développement avec agents IA (Claude Code, Cursor, etc.), offrant des garde-fous pour maintenir la cohérence du design tout en permettant des écarts intentionnels, comme pousser une direction 'crazy' avec un risque élevé mais contrôlé.

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

Que fait do-design ?

Les chemins sont relatifs au dossier de ce skill ; P est la racine du projet. Les scripts sont du Python 3.8+ de la bibliothèque standard. Exécutez le script avant de raisonner sur tout ce qu'il mesure, citez sa sortie, et ne déduisez ou n'estimez jamais ce qu'il rapporte.

Modèle

  1. Le DESIGN.md du projet (le document) est contraignant et prime sur ce skill. En cas de conflit, le document gagne ; dites-le.
  2. Chaque règle porte sa raison. Une règle sans raison est supprimée la première fois qu'elle gêne.
  3. Des preuves avant les valeurs par défaut. Un bref brief ("faites-le nouveau" + un logo) est une raison de rechercher, pas de recourir à l'apparence habituelle ou d'inventer des faits. Pas de source, pas d'affirmation : marquez l'écart ou demandez.
  4. Chargez paresseusement. Seulement les fichiers que le tableau des commandes nomme. Des couches supplémentaires "pour être complet" sont un échec de méthode.
  5. La convention est la valeur par défaut, pas l'échec. Le mode décide à quel point s'en écarter.

Modes : indiquez une ligne au début de chaque commande

ModeLe visiteur estPousser
Persuaderen train de décider et d'agirfort : un modèle est un échec
Opéreren train d'accomplir une tâcheretenue : la convention est une fonctionnalité
Lireen train de comprendre quelque chosemoyen : le confort de lecture prime
Expérienceà l'intérieur de l'œuvre elle-mêmefort : l'artefact mène

Choisissez par surface, pas par produit : la page d'accueil d'un outil de développement est Persuader, son écran de configuration Opérer.

Commandes : chargez un fichier de commande, plus ce que ses lignes nomment

CommandeQuand l'utiliserCharger aussiRisque
do-design-review"est-ce que ça correspond au document ?" Le moins cher, exécutez-le le plusle DESIGN.md du projet-
do-audit"à quel point est-ce bon ?" Score + constats classésreferences/critique-rubric.md, references/slop-catalog.md, les couches 00-05 que le périmètre touche-
do-design-new"construire X" : conventionnel, compétent, conforme au documentlayers/00, les 1-3 couches que la tâche touche ; layers/06 quand le brief est mince ou orienté clientfaible
do-design-renew"refaire cette apparence" : nouveau monde, même vérité produitlayers/00, layers/06moyen
do-crazy"quelque chose que personne dans ce secteur ne ferait"layers/00, layers/06élevé, par conception

Couches : 00-craft-floor (tous les modes) · 01-couleur · 02-typographie · 03-espace-disposition · 04-mouvement-états · 05-voix · 06-recherche. Rédiger un document : templates/DESIGN.md, examples/01-two-papers.md, references/interview.md.

Scripts (tous acceptent --json)

ExécutionDonne
scripts/check-design.py --root Pl'écart par rapport au bloc de jetons du document. Code de sortie 0 propre, 1 écart, 2 pas de document/jetons. --init ébauche les jetons à partir du code
scripts/audit.py scan Ples signes sources (ID comme dans le catalogue slop), les lacunes d'accessibilité et de surface navigateur, l'inventaire de valeur
scripts/audit.py copy Ples signes de prose et de microcopie, le rythme des phrases, les marqueurs de lacune non comblés
scripts/audit.py contrast FG BG / --paper P/DESIGN.mdles ratios WCAG
scripts/audit.py score H L S C T U Dle score pondéré, la bande, la liste de travail
scripts/render-audit.py URL-or-file [--shots DIR] [--inject-css FILE]la page peinte à 1280/768/390 : chevauchement, défilement latéral, rognage, contraste peint, cibles tactiles, visibilité du focus. --inject-css mesure une correction CSS sur la page déployée avant de déployer. Nécessite Chrome/Chromium
`scripts/research.py suggestprofile
bash scripts/install-guardrails.sh PDESIGN.md à partir du modèle, le bloc AGENTS.md/CLAUDE.md, le vérificateur

Les captures d'écran coûtent beaucoup plus de contexte que la sortie du script : ne les prenez que pour ce qui nécessite des yeux (hiérarchie, distinction, composition), uniquement la zone d'affichage, d'abord à 390. Les scripts peuvent aussi se tromper : avant de signaler un P0 qui semble invraisemblable, confirmez-le une fois (une capture d'écran ciblée ou la géométrie de l'élément), et corrigez le script si c'était un faux positif.

Définitions partagées

Test d'échange. Remplacez le nom du produit par celui d'un concurrent. Si rien ne se casse, la page ne dit rien sur ce produit : non choisi, pas laid. Corrigez-le dans la copie, le visuel et un détail de signature, jamais en ajoutant de la décoration.

Direction, cinq lignes. Écrite avant de construire, montrée, puis attendez un oui (si on vous dit "faites-le", énoncez l'hypothèse en une ligne et allez-y) :

Produit :    ce qu'il fait, pour qui, une phrase simple
Caractère :  2-3 mots concrets (jamais propre, moderne, élégant, minimal, premium)
Monde :      le lieu ou le matériau auquel il appartient ; définit la teinte neutre, l'accent, l'imagerie
Moments :    1-2 endroits où l'écran devient riche
Signature :  un détail que seul ce produit a, utilisé de manière cohérente

Marqueur de lacune. [nombre nécessaire], [source nécessaire], [photo nécessaire] là où un fait ou un bien manque. audit.py copy liste ceux qui sont encore ouverts ; aucun ne peut être livré.

Notation : chaque commande d'évaluation se termine par celle-ci

#ChampQuestionP
1HiérarchieLa chose la plus importante peut-elle être nommée en 2 secondes ?3
2LisibilitéContraste, taille, mesure, copie réelle à chaque largeur3
3SystèmeUne palette, une échelle, une logique de rayon, un langage de mouvement2
4FactureAlignement, rythme des espacements, états, surfaces navigateur2
5Vérité du contenuDonnées réelles, copie spécifique, aucune affirmation inventée3
6UtilisabilitéLa tâche se termine ; les affordances sont évidentes ; les erreurs sont récupérables3
7DistinctionPasse-t-il le test d'échange ?2

Notez chaque champ de 0 à 4 (4 = vraiment excellent, pas "correct") et calculez avec audit.py score. Bandes : 85+ Fort, livrez et corrigez uniquement les P0 · 70-84 Solide, livrez après les P1 nommés · 50-69 Faible, une vraie révision d'abord · <50 Échec, la direction est erronée : reconstruisez (do-design-renew). Notez le rendu, pas la source. Un champ que vous n'avez pas pu vérifier est u : il marque 0 et se lit non vérifié, jamais une estimation. La distinction obtient 4 seulement si vous pouvez nommer ce qui fait que c'est celui de ce produit. Les trois pires champs sont la liste de travail, une action chacun.

Sévérité : P0 bloque la livraison (cassé, illisible, interdiction formelle), signalez tous · P1 endommage la confiance, top 5 · P2 facture, top 5 · P3 polissage, listez seulement. Format du constat : [Pn] emplacement - ce qui ne va pas - correction ; les constats de script conservent leur ID.

Pas de document

Dites "Pas de DESIGN.md : la garde-fou n'a rien à appliquer." Proposez de l'écrire (modèle + entretien), ou une rétro-ingénierie à partir du code (check-design.py --init + entretien §Rétro-ingénierie) : la v1.0 est ce qui est livré, les anciennes valeurs vont dans legacy: (comptées, pas échouées), les lacunes dans la liste des écarts du document. Les archives et démos restent en dehors de chaque analyse via skip: dans le bloc de jetons (ou --skip a,b), par dossier ou fichier. Grep pour les importations avant de sauter : les dossiers d'archives contiennent souvent des parties actives. N'inventez jamais de document pour que le vérificateur passe.

Non-négociables

  1. Ne cassez jamais du code fonctionnel. Les props, l'état, le routage, les gestionnaires et l'accessibilité survivent ; la copie conserve son sens.
  2. Le brief gagne. Une marque, police ou couleur énoncée l'emporte sur le goût, même sur une liste de refus. Écrivez-la dans le document (allow: dans le bloc de jetons désactive intentionnellement une règle du vérificateur ou un ID d'audit).
  3. N'inventez jamais de faits, d'actifs ou de sources. Supprimez une affirmation vague ; ne la remplacez jamais par un spécifique inventé. Utilisez un marqueur de lacune.
  4. Gardez la voix de l'auteur. Supprimez les habitudes de machine, conservez les bizarreries de la personne.
  5. Densité, pas présence. Agissez sur des clusters (3+ signes P0/P1 distincts), jamais sur un dégradé ou un tiret em. Un résultat propre est valide ; ne fabriquez jamais de constats.
  6. Corrigez, n'accusez jamais. Ne dites jamais "cela semble généré par IA" ; nommez ce qui n'est pas choisi et quoi faire à la place.
  7. Lecture seule sauf demande pour les critiques et audits.

Skills associés