Communitygithub.com

craft

Utilisez cette compétence lorsque vous devez concevoir, créer, maquetter ou refondre une ou plusieurs pages, écrans, flux ou éléments d'interface, ou lorsque la personne exécute /craft (/craft:craft dans le plugin Claude Code).

Qu'est-ce que craft ?

Craft est la compétence de conception visuelle d'un agent d'IA, conçue pour transformer une demande vague comme « conçois la page de tarification » en un design terminé et revu. Elle s'appuie sur le brief du projet, couvre tous les états d'interface (normal, vide, erreur, etc.), ne propose des options que lorsque la direction est ouverte, utilise exclusivement les éléments du système de design existant, et vérifie son propre travail avant de le montrer. Elle orchestre des sous-compétences spécialisées (`craft-setup`, `craft-states`, `craft-explore`, `craft-system`, `craft-sync`, `craft-critique`) à des points fixes du processus, sans les remplacer. Cette compétence fonctionne avec n'importe quel outil de design (Figma, Sketch, etc.) via des adaptateurs dans `references/adapters/`, ou en dernier recours en HTML. Elle suit un processus strict en 4 étapes : contexte (lecture de `DESIGN.md`, du système de design, résolution des conflits entre brief et code), scope (liste et confirmation des items à créer), exécution (états, exploration optionnelle, dessin avec les tokens système, auto-critique), et clôture (résumé, mise à jour de `DESIGN.md`). Les « arrêts » sont obligatoires : l'agent doit terminer son tour avec une question et attendre la réponse, sans jamais décider à la place de l'utilisateur pour gagner du temps.

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

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 craft ?

Aperçu

La porte d'entrée pour tout ce qui est visuel. Elle transforme « conçois la page de tarification » en un design terminé et revu. Elle part du brief du projet, couvre tous les états, offre des options uniquement lorsque la direction est ouverte, utilise uniquement les éléments du système de design, et vérifie son propre travail avant de le montrer. Elle appelle les autres compétences de design à des points fixes ; elle ne les remplace pas.

Quand l'utiliser

  • « Design / Crée / Maquette / Refonds la <page, écran, flux, élément> », /craft (/craft:craft dans le plugin Claude Code).
  • Plusieurs pages à la fois (« conçois l'onboarding : bienvenue, inscription, vérification »).

Quand NE PAS l'utiliser

  • Une petite modification que la personne a décrite exactement (une valeur, un libellé, une taille) : faites-la.
  • Uniquement une revue (« qu'est-ce qui cloche là-dedans ? ») : craft-critique. Uniquement des options : craft-explore.

Avant de commencer

  • Si aucun adaptateur dans references/adapters/ ne correspond à votre outil, effectuez les mêmes actions dans votre outil et dites lesquelles vous avez mappées manuellement. Sans outil de design du tout, construisez en HTML (html.md). Si vous ne disposez que d'une image, dites que les valeurs lues sont des estimations.

Les arrêts sont réels

Un arrêt signifie : terminez votre tour par la question et attendez. Vous pouvez toujours le faire, même dans une session unique ou sans tête, où votre message final est la question. Ne décidez jamais d'un arrêt à la place de la personne parce que la session « ne peut pas attendre » ou « pour économiser un aller-retour ». Le décider vous-même transforme une réponse de cinq secondes en des heures de reprise.

Étapes

  1. Contexte.
    • Lisez DESIGN.md à la racine du projet. S'il manque, ou n'a pas de section Produit (un enregistrement de synchronisation uniquement) → SOUS-COMPÉTENCE REQUISE : craft-setup, puis revenez ici.
    • Lisez le système de design (tokens, composants, guide) et les écrans liés à celui-ci.
    • Lorsque le brief et le code sont en désaccord (le brief dit turquoise, les tokens disent bleu) : suivez le code, dites-le en une ligne, ajoutez le conflit à DESIGN.md › Questions ouvertes, et proposez de mettre à jour ce qui est erroné. Ne remplacez jamais les tokens dans le CSS d'une page.
    • Lorsque le guide de l'outil de design et le code diffèrent et qu'un design-sync.json existe, ne déclarez pas le guide obsolète. Classez-le avec : code modifié → proposez de rafraîchir le guide avant de dessiner ; guide modifié → c'est le changement de la personne qui attend une exportation, dessinez donc avec et mentionnez l'exportation en attente.
  2. Périmètre en mots. Listez chaque page ou élément à créer, chacun avec son rôle et sa prochaine action unique.
    • Les mots ambigus reçoivent une interprétation clairement énoncée (« page de tarification = la liste de prix de la boulangerie, pas les plans d'abonnement »).
    • Arrêtez-vous et confirmez la liste lorsqu'il y a plus d'un élément ou que la demande est vague. Un seul élément clair : continuez.
  3. Pour chaque élément, dans l'ordre :
    1. SOUS-COMPÉTENCE REQUISE : craft-states. Sa liste d'états écrite et son arrêt viennent en premier.
    2. Direction ouverte ? Uniquement lorsque la personne a demandé des idées, ou lorsque deux mises en page structurellement différentes sont plausibles et que ni le brief ni le système ne les départage → SOUS-COMPÉTENCE REQUISE : craft-explore avant de dessiner les états. Pour plusieurs pages, demandez lors de l'arrêt du périmètre quelle page (le cas échéant) reçoit des options ; n'exécutez jamais un tour d'options par page par défaut. Les états sont ensuite dessinés dans la direction choisie. Un écran qui suit un modèle existant va directement au dessin.
    3. Dessinez l'état principal, puis les autres états, en utilisant uniquement les éléments et tokens du système. Quelque chose de nouveau (un composant, une couleur, une taille que l'échelle ne possède pas) → SOUS-COMPÉTENCE REQUISE : craft-system (mode ajout) avant de l'utiliser. Un composant qui existe dans le code mais n'est pas dessiné dans l'outil (« dans le code uniquement » dans l'index) → SOUS-COMPÉTENCE REQUISE : craft-sync (import d'un composant), en dessinant d'abord ce composant uniquement. Si la personne a refusé l'import (voir DESIGN.md), demandez une fois avant d'importer ; si elle dit toujours non, construisez à partir des valeurs du code sur le tableau lui-même et notez-le. Ne dessinez jamais d'imitation, et ne codez jamais en dur une nouvelle valeur dans une page.
    4. SOUS-COMPÉTENCE REQUISE : craft-critique en mode auto-vérification sur chaque tableau : rendez-le, corrigez ce qu'il trouve dans le périmètre de cette tâche, et rendez-le à nouveau.
  4. Clôture.
    • Montrez le résultat avec le résumé ci-dessous.
    • Ajoutez les décisions à DESIGN.md › Journal des décisions (date, décision, pourquoi).
    • Déplacez toute question ayant obtenu une réponse hors des Questions ouvertes.

Résumé de clôture (la forme de votre message final)

Réalisé : <pages/éléments> — <où : fichiers ou tableaux>
Décisions : <chacune, une ligne avec son pourquoi> (aussi dans DESIGN.md › Journal des décisions)
Modifications système : <éléments ou tokens ajoutés/modifiés> — impacte : <écrans>
Corrections auto-vérification : <ce que craft-critique a changé avant que vous ne le voyiez>
Questions ouvertes : <ce que la personne doit encore décider>

Règles

RèglePourquoi
DESIGN.md d'abord, à chaque foisSans le brief, chaque écran invente son propre style
Périmètre confirmé avant le travail lorsqu'il y a plus d'un élémentTrois pages construites sur une mauvaise lecture, c'est trois pages gaspillées
Liste des états avant de dessiner (via craft-states)Le chemin heureux n'est qu'un état parmi d'autres
Options uniquement lorsque la direction est ouverteDes options sur un modèle résolu gaspillent l'attention de la personne
Uniquement les éléments et tokens du système ; les nouveaux passent par craft-systemLes valeurs codées en dur dans les pages sont là où la dérive commence
Le code prime sur un brief obsolète ; notez-le, ne le remplacez pasLes tokens sont ce qui est livré ; le brief est mis à jour par décision, pas en silence
Auto-vérification avant de montrerLa personne doit revoir le design, pas attraper les erreurs
Les décisions vont dans DESIGN.mdLa conception de la session suivante part de là, pas de la mémoire

Terminé lorsque

Chaque élément du périmètre confirmé a ses états dessinés et auto-vérifiés, toute modification système est passée par craft-system, le résumé de clôture a été donné, et le journal des décisions de DESIGN.md a été mis à jour.

Erreurs courantes

PenséeRéalité
« Trois pages sont assez claires, je vais juste les construire »Confirmez d'abord la liste. Cela coûte un message.
« Je vais faire des boutons de 52px ici ; le token dit 44, mais ce public a besoin de plus grand »C'est une décision système. Proposez-la via craft-system, puis utilisez-la partout.
« Le brief dit turquoise, donc je vais remplacer le bleu dans le CSS de cette page »Le code prime. Signalez le conflit et demandez ; ne corrigez jamais les tokens localement.
« Je vais montrer, ils me diront ce qui ne va pas »Exécutez d'abord craft-critique en mode auto-vérification, et dites ce qu'il a corrigé.
« Les décisions sont dans mon message, ça suffit »Les messages défilent. Ajoutez-les à DESIGN.md.
« Cette session ne peut pas s'arrêter pour des réponses, donc je vais prendre les décisions moi-même et les lister »Terminer votre tour par la question est s'arrêter. Faites cela ; ne construisez rien après le premier arrêt ouvert.
« Pour économiser un aller-retour, je vais mettre les deux arrêts dans un seul message »Très bien, si vous vous arrêtez ensuite. Posez les deux questions, ne construisez rien, attendez.

Individual skills in this repo

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

Skills associés