Communitygithub.com

design-craft

Indique à un agent comment diriger artistiquement et construire un « design craft » pour produire concrètement une page d'atterrissage, une page d'accueil ou un portfolio. La procédure passe par le Design craft, l'Ordre des besoins, 1. Cadrer (avant tout code). À utiliser lorsqu'une nouvelle mission nécessite ce savoir-faire.

Qu'est-ce que design-craft ?

Ce skill, nommé « design-craft », fournit à un agent IA une méthode de travail complète pour la conception et le développement frontend, en se concentrant sur la création de pages d'atterrissage, de pages d'accueil ou de portfolios de haute qualité. Il guide l'agent à travers un processus en 8 étapes, allant du cadrage initial (avant tout code) à la vérification dans un navigateur réel. L'approche est centrée sur l'« Ordre des besoins » (fonctionnel → fiable → utilisable → plaisant), garantissant que les aspects agréables ne sont ajoutés qu'après avoir solidifié les bases fonctionnelles et de fiabilité. Le skill insiste sur la recherche d'une « signature » dans le sujet traité, l'exploration rapide de différentes approches, la priorisation du système de design (tokens, composants), la gestion de tous les états (y compris les cas d'erreur et de chargement), l'émotion et l'honnêteté dans le contenu, ainsi que des principes de motion bien définis. Il prend en charge l'utilisation avec n'importe quel agent capable de suivre des instructions markdown et des fichiers de référence. Le fonctionnement repose sur la lecture du fichier `SKILL.md` principal et de fichiers de référence supplémentaires dans un dossier `references/`, chacun étant déclenché par des situations spécifiques listées dans un tableau à la fin du document.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Iitian001/design-craft/tree/HEAD/skills/design-craft

Demander à votre IA préférée

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

Documentation

Design craft

Une méthode de travail pour le design et le développement frontend. SKILL.md contient ce dont chaque tâche a besoin ; les fichiers references/ fournissent la profondeur, les chiffres et le code. Lisez-en un lorsque son déclencheur dans le tableau à la fin s'applique.

Périmètre : une nouvelle page, un flux ou un composant exécute les étapes 1 à 8. Une petite modification (un état, une animation, une chaîne de caractères) exécute uniquement les étapes qu'elle touche, puis l'étape 8 sur ce qui a changé.

Ordre des besoins

Fonctionnel → fiable → utilisable → plaisant. N'ajoutez jamais de plaisir à quelque chose de cassé, lent ou déroutant, et ne livrez jamais sans la couche supérieure non plus : la personnalité remise à "plus tard" est rarement livrée.

1. Cadrer (avant tout code)

  • Histoire de tâche : Quand [situation], je veux [motivation], afin de [résultat]. Situation ou résultat inconnu → demandez, ou formulez l'hypothèse comme telle dans votre résumé.
  • Choisissez l'ambition demandée par le brief et concentrez vos efforts là-dessus :
BriefInvestir dansPremière preuve
Site de marque, "premium", "de niveau récompense", "plein d'animations"Une interaction signature ancrée dans le sujet (étape 2)L'interaction fonctionnant sur du contenu réel : début, milieu, interruption, relâchement
Page de lancement, éditoriale, marketingL'offre est claire et sa meilleure preuve est explorablePremier écran lu sur un téléphone ; action principale accessible sans attente
Application, outil, tableau de bordLa décision la plus difficile, le coût d'une erreur, la rapidité d'utilisation répétéeUne tâche réaliste avec des données changeantes, plus la récupération après un échec
Composant ou système de designUn contrat comportemental qui survit à deux consommateurs différentsLe même composant dans deux contextes avec du contenu long
  • Séparez les faits des hypothèses. Nommez l'état émotionnel du visiteur à son arrivée ; cela donne le ton.
  • Vérifiez ce qui existe : tokens, composants, motifs, conventions. Réutilisez avant d'inventer.

2. Trouver la signature dans le sujet

Pour un travail expressif, recherchez une propriété du sujet que le visiteur reconnaîtrait même avec le logo caché, et un verbe qui lui permet de la diriger. Une bière coule, mousse et montre sa couleur ; un tissu drapé ; une police a des axes ; une montre a un mouvement. Concevez l'interaction autour de cette propriété.

  • Test de substitution : remplacez par une marque sans rapport. Si l'effet fonctionne toujours inchangé, ce n'est pas encore à propos du sujet. Revenez au sujet avant d'ajouter du polissage.
  • Quatre temps : qu'est-ce qui invite à l'interaction → ce qui répond au contact → ce qui est révélé sous une interaction soutenue → ce qui reste après relâchement. Un objet persistant devrait porter les quatre.
  • Plus d'effets ne corrigent jamais "ça semble basique". Changez plutôt l'idée centrale ou le mécanisme.
  • Chaque geste a un équivalent simple (un curseur, un bouton, un groupe de boutons radio) qui accède aux mêmes informations.

3. Explorer à moindre coût, prouver la partie la plus difficile en premier

  • Décrivez au moins trois approches structurellement différentes en quelques lignes chacune. Choisissez-en une, expliquez pourquoi.
  • Composez une image fixe avec du contenu réel avant le mouvement : ordre de lecture, typographie, imagerie, action principale. Une image prise au milieu d'une animation doit aussi sembler intentionnelle.
  • Construisez d'abord l'affirmation la plus risquée (le geste, la scène de défilement, le workflow difficile) et vérifiez-la dans un vrai navigateur avant de construire le reste de la page autour.

4. Le système d'abord

  • Les tokens avant les composants. Les composants consomment des tokens sémantiques (--color-action) qui alias des primitives (--amber-400). Pas de hex, px ou nombres magiques dans les styles des composants.
  • Espacement sur une échelle basée sur 4 (4, 8, 12, 16, 24, 32, 48, 64). Corps de texte 16px/1rem avec un interlignage de 1.5 ; titres 1.1-1.25. Un ratio typographique modulaire. Deux polices max (+ mono). Chiffres tabulaires pour les nombres changeants.
  • 1-3 couleurs de marque, neutres, couleurs d'état. Chaque paire de texte passe WCAG AA (4.5:1 pour le corps, 3:1 pour le texte large/UI). La couleur n'est jamais le seul signal.
  • Les tokens de mouvement (durées, easings) vivent à côté de la couleur et de l'espacement.
  • Les props nomment la signification (variant="destructive"), pas l'apparence. Les écrasements répétés signifient une variante manquante.

5. Tous les états, pas seulement le chemin heureux

Composants interactifs : défaut, survol, focus-visible, actif, désactivé, chargement, erreur, sélectionné. Écrans : vide, chargement, partiel, erreur, succès, hors ligne. Travail asynchrone :

  • La dernière requête gagne ; une réponse lente et ancienne ne doit pas écraser une réponse plus récente.
  • Conservez la saisie de l'utilisateur après toute défaillance et gardez les résultats précédents visibles (atténués) pendant le chargement.
  • Compte vide, aucun résultat et échec de récupération sont des états différents avec des actions suivantes différentes.

Utilisable au clavier, HTML sémantique d'abord, ARIA uniquement là où le HTML ne peut pas l'exprimer, une étiquette sur chaque champ, une sortie visible de chaque modal, et le focus retourné à quelque chose de pertinent lorsqu'il se ferme.

6. Émotion, copie et honnêteté

  • La clarté bat l'esprit. Si une blague nécessite une phrase supplémentaire, coupez-la. Contractions, mots simples.
  • La voix est constante, le ton change : chaleureux en cas de succès, simple et calme en cas d'erreur, doux pour les données sensibles.
  • Erreurs : ce qui s'est passé, pourquoi, que faire ensuite, et ce qui a été conservé. Ne blâmez jamais l'utilisateur. Pas d'humour ici.
  • États vides invitent : ce qui apparaîtra ici plus une première action claire.
  • Pic-fin : placez le grand plaisir à la fin d'un véritable accomplissement, jamais dans une vallée de frustration.
  • Sur les pages à fort enjeu, nommez les craintes du visiteur et répondez à chacune avant l'appel à l'action.
  • Imagerie : une distribution diversifiée par défaut ; demandez "qui excluons-nous ?"
  • Honnêteté : étiquetez les images générées par IA et les données de démonstration là où les gens pourraient les prendre pour réelles. Le texte doit correspondre à ce que montrent les images (une canette qui affiche 5,0 % signifie que la page dit 5,0 %).
  • Catégories réglementées (alcool, finance, santé, enfants) : ajoutez la barrière ou la divulgation requise et vérifiez l'imagerie par rapport aux normes publicitaires de la catégorie, par exemple pas d'imagerie sexualisée pour l'alcool.

7. Mouvement

Chaque animation a un travail : contexte, attention, retour ou personnalité. Pas de travail, pas d'animation.

TokenValeurUtilisation
--dur-1100mspression, focus, bascule (≈ le seuil perceptuel)
--dur-2200msla plupart des transitions UI, survol, petite entrée
--dur-3300mspanneaux, tiroirs, modaux
--dur-4400-500msseulement pour la chorégraphie plein écran ou héros
--ease-outcubic-bezier(0,0,.2,1)entrée / attirer l'attention
--ease-incubic-bezier(.4,0,1,1)sortie / perdre l'attention (les sorties sont ~20-30 % plus courtes)
--ease-in-outcubic-bezier(.4,0,.2,1)déplacement entre des positions à l'écran
ressortamorti critique, reciblablegestes ; préserver la vélocité lorsque la cible change
  • Ne bloquez jamais l'action principale sur la chorégraphie. Un préchargeur ou une intro ne doit pas retenir l'action principale pendant plus d'une seconde environ, et les visiteurs qui reviennent la sautent.
  • Cohérence spatiale : les choses partent par où elles sont venues ; les éléments partagés se transforment sur place.
  • Stagger 30-60ms avec un délai décroissant (base*√i) ; gardez la séquence entière sous ~300ms.
  • Scènes de défilement : la progression est mappée à partir du parcours mesuré de la section, de sorte que la même position de défilement donne toujours la même image, le défilement vers le haut s'inverse proprement, et les liens directs vers le milieu fonctionnent.
  • Gestes : un propriétaire de la progression ; la prise reste attachée au pointeur ; le relâchement donne la vélocité à un ressort ; l'interruption en plein vol laisse l'interface utilisateur opérationnelle.
  • Animer uniquement transform et opacity. Sous prefers-reduced-motion, supprimez le déplacement, le parallaxe, le zoom et la lecture automatique, conservez les fondus courts, et laissez toujours les gestes initiés par l'utilisateur fonctionner.
  • Pièges d'ingénierie qui ont cassé des builds réels (une propriété, un propriétaire ; timelines de défilement en pause ; étiquettes d'accroche dans la timeline ; temps d'image non négatif ; préchargement d'actifs échangeables) : references/motion-engineering.md.

8. Vérifier dans un vrai navigateur, puis remettre

Exécutez scripts/walk.py (Playwright + Chrome local) sur le bureau, le téléphone et avec mouvement réduit : glisser réel du pointeur, défiler dans chaque section, erreurs console, débordement latéral. Un volet d'aperçu caché ou réduit limite les images d'animation, ne jugez donc pas le mouvement à partir de celui-ci. Détails : references/verification.md.

Ensuite, critiquez par rapport à l'histoire de la tâche, pas au goût :

  1. Répond-elle à l'histoire de la tâche ? L'action principale est-elle la chose la plus visible et accessible partout ?
  2. Tous les états présents (étape 5) ? Clavier, étiquettes de lecteur d'écran, contraste ?
  3. Uniquement des tokens ? Composants existants réutilisés ?
  4. La copie suit-elle l'étape 6, y compris les étiquettes d'honnêteté ?
  5. Chaque animation a-t-elle un travail, la bonne direction d'easing, un chemin d'interruption et un chemin pour mouvement réduit ?
  6. La signature passe-t-elle le test de substitution ? Y a-t-il un pic, placé à une fin ?
  7. Que supprimerais-je ? Retirez un élément ou un effet et voyez si cela s'améliore.

Remettez avec la justification : le problème, l'approche, les alternatives rejetées et pourquoi, ce qui a été exercé et comment (émulation vs un vrai appareil), et les limites connues. Modèle : references/process-and-teams.md Annexe B.

Références

LireQuand
references/motion-engineering.mdlors de la construction de tout travail GSAP/ScrollTrigger/Lenis, canvas, geste ou scène de défilement
references/verification.mdavant de déclarer tout travail visuel ou interactif terminé
references/imagery.mdlors de la génération ou préparation d'images, découpes de produits, direction artistique
references/animation.mdchorégraphie, les 7 principes de mouvement, mathématiques de stagger, tokens de mouvement
references/emotion.mdpersona de design, intégration, plaisir, confiance et peur, copie de panne
references/design-systems.mdtokens, API de composants, gouvernance, versionnage, documentation
references/product-design.mdrecherche, histoire d'abord, croquis, retour, prototypage, tests
references/design-thinking.mdun problème ambigu nécessitant empathie/définition/idéation/prototypage/test
references/design-engineering.mdchoix de la fidélité du prototype, poignée de main design↔code
references/process-and-teams.mdsessions de critique, modèles de justification et de remise, DesignOps

Skills associés