Communitygithub.com

Craft UI

Créez des mises en page pilotées par les références, en commençant par un contrat de conception, jamais par une hypothèse. Assistant de conception SaaS, CRM, landing page, effets GSAP/Figma.

Qu'est-ce que Craft UI ?

Craft UI est une compétence d'agent IA de conception professionnel qui élimine le 'slop' générique de l'IA en forçant chaque décision structurelle et visuelle à être traçable par rapport à trois sources de preuves : le produit en production, le brief de l'utilisateur et les références visuelles réellement observées. Avant toute écriture de code, le flux de travail exécute trois agents de découverte parallèles (Analyste du site de production, Analyste des demandes et références, Routeur de compétences/économie) qui fusionnent leurs résultats dans un contrat de conception formel. Ce contrat agit comme une porte verrouillée : aucune ligne de code n'est écrite tant que les conflits ne sont pas résolus, que les inconnues ne sont pas traitées et que la structure n'est pas justifiée. La compétence prend en charge plusieurs plateformes (OpenCode, Claude Code, Codex, Cursor) et fournit des budgets de mots, des schémas et des références pour la qualité, le transfert de motifs et les effets de mouvement. Une fois le contrat signé, la compétence génère un plan lean, construit un fichier HTML autonome (ou utilise React/Tailwind existant), ajoute un seul effet de mouvement mémorable, vérifie visuellement la réactivité aux trois largeurs et livre les résultats avec des limites connues et des prochaines étapes suggérées, le tout dans la langue de l'utilisateur. La barre de qualité professionnelle est non négociable : contenu réel, fidélité visuelle, responsive, WCAG AA, performances et transfert.

Compatible avec✓Claude Code✓Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/Fast4gc/craft-ui/tree/HEAD/skills/craft-ui

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

Image de référence entrée, mise en page fonctionnelle sortie — mais seulement après que le produit et la demande sont compris.

L'échec que cette compétence existe pour éviter : une page d'apparence plausible faite de sections aléatoires, de texte provisoire, de dégradés par défaut et de bandes vides. Cela se produit lorsqu'un agent conçoit à partir d'habitudes de genre au lieu de preuves. Ici, chaque décision structurelle et visuelle doit remonter à l'une des trois sources : le produit en production, le brief de l'utilisateur, ou une référence réellement vue. Si une source manque, rassemblez-la ou demandez-la. Ne comblez jamais le vide avec une valeur par défaut.

Règles non négociables

  1. Pas de code avant le Contrat de conception (étape 2). Aucune exception pour les pages "rapides" : discovery: lite raccourcit le contrat, elle ne le supprime pas. L'économie est gérée par le routeur, pas en sautant le contexte.
  2. Preuves plutôt que valeurs par défaut. Chaque élément, section et ligne de texte cite sa provenance. "Typique pour les pages d'atterrissage" n'est pas une source.
  3. La structure est une colonne vertébrale, pas un buffet. Les sections n'existent que si elles répondent à une question du visiteur ou à un objectif du brief. Voir references/anti-ai-slop.md.
  4. Contenu réel. Le nom du produit, les étiquettes, les données et la langue proviennent du site/brief. Pas de lorem, pas de faux logos, pas de métriques inventées, pas de "Votre produit ici" sauf si l'utilisateur a approuvé un espace réservé.
  5. Répondre dans la langue de l'utilisateur et construire l'interface utilisateur dans la langue du produit (un produit pt-BR reçoit un texte pt-BR).
  6. Un seul mouvement mémorable, pas un fondu enchaîné sur chaque section.
  7. Les tokens avant les composants. Les couleurs, les rayons, la typographie, l'espacement, les ombres et l'assouplissement vivent dans les variables CSS ; les composants ne lisent que celles-ci.
  8. L'économie est une décision. Le routeur définit la verbosité et les compétences qui s'exécutent. Lisez uniquement les sections de référence qui s'appliquent.
  9. Barre de qualité professionnelle. references/quality-bar.md est la définition de "fait" — contenu, fidélité visuelle, responsive, WCAG AA, performances et transfert. terse le vérifie silencieusement ; il n'est jamais ignoré.

Flux de travail

0. Triage (agent principal, secondes)

  • Capturez la demande de l'utilisateur textuellement ; notez toute URL, pièce jointe, contrainte "não quero" et indices de verbosité ("só o código", "rápido", "me explica").
  • Vérifiez ce qui est disponible : outil de sous-agent/tâche, navigateur ou récupération web, dépôt local, liste de compétences/MCP.
  • Si la demande est une petite retouche d'un fichier existant (une couleur, une valeur d'espacement), dites-le au routeur — il peut définir discovery: lite. Une nouvelle page ou une refonte obtient toujours discovery: full.
  • Si l'utilisateur dit que la mise en page existante est "amador", "precisa melhorar", "conserta essa landing" ou pointe vers un site live avec du code, lisez references/polish-existing-site.md et suivez ce chemin : polissage additif de la base de code réelle, pas une reconstruction. Exécutez git status avant de toucher aux fichiers.

1. Trois agents de découverte (exécutés en parallèle)

Utilisez votre outil de sous-agent — OpenCode subagent, Claude Code Task/Agent, Codex spawn_agent, Cursor background agent. S'il n'y a pas d'outil de sous-agent, exécutez les trois passages séquentiellement dans l'agent principal et étiquetez chacun avec son en-tête. Les agents de découverte n'écrivent pas de code.

AgentMissionAlimente le contrat avec
A — Analyste du site de productionComprendre le site tel qu'il existe en production : produit, public, texte réel, structure actuelle, tokens de marque, contraintes.SITE CONTEXT BRIEF
B — Analyste des demandes et référencesDécoder la demande réelle et extraire l'ADN de style uniquement à partir de références réellement vues ; rechercher des références lorsqu'aucune n'a été donnée.REQUEST BRIEF + STYLE DNA
C — Routeur de compétences / ÉconomieChoisir l'ensemble minimum de compétences/outils supplémentaires pour cette exécution et définir la verbosité.ROUTING DECISION

Spécifications complètes, schémas de sortie et budgets de mots : references/agents.md. Passez à chaque agent le chemin racine absolu de la compétence, sa spécification de rôle, la demande brute de l'utilisateur, et les URL/pièces jointes. Limitez les retours à leurs budgets de mots.

Lorsqu'une image de référence est impliquée, lisez également references/pattern-transfer.md. Les tokens de style voyagent ; les recettes de composition non. N'adoptez jamais un motif de héros ou de section uniquement à partir de la référence — il doit être justifié par le produit (A) et la demande (B).

2. Contrat de conception — porte verrouillée

Lisez references/design-contract.md. Fusionnez A + B + C en un seul contrat. Ensuite, vérifiez :

  • La colonne vertébrale de la structure est ordonnée ; chaque section a un travail, une source, une topologie copiée littéralement de la référence et un contenu réel ; il n'y a pas de bande vide.
  • Chaque token et ligne de texte cite une source ; les inconnues sont marquées, pas inventées.
  • Les conflits entre agents/site/référence ont été résolus en posant à l'utilisateur une question consolidée (max 3 éléments), pas en devinant.
  • La verbosité et la liste de compétences proviennent de C ; aucune compétence n'est exécutée "juste parce qu'elle existe".
  • Un registre d'adoption de motifs existe : chaque adopt/adapt/drop cite A et B ; aucune recette de héros/section ne provient uniquement de la référence (voir references/pattern-transfer.md).
  • La composition ne serait pas plausible pour un produit sans rapport dans un domaine différent. Les tokens sont portables ; la recette du héros ne l'est pas.

Les sous-agents de découverte ne posent jamais de question à l'utilisateur — ils rapportent seulement les Lacunes / Inconnues. L'agent principal collecte les trois briefs, pose une question consolidée (max 3 éléments) et maintient la porte verrouillée jusqu'à ce qu'elle soit répondue. Si un fait matériel est encore inconnu (nom du produit, public, contenu réel, image de référence), demandez et arrêtez-vous. Ne commencez pas l'étape 3.

3. Plan

Plan compact : tokens, wireframe ASCII de la colonne vertébrale, banque de texte réel/données réelles, et le moment du seul mouvement avec son déclencheur et sa raison. Comparez avec la référence et le brief du site ; tout ce qui est une valeur par défaut plutôt qu'une chose observée est révisé ou supprimé.

4. Construire

  • Un seul fichier HTML autonome par défaut (variables CSS comme tokens, polices Google avec des fallbacks réelles). Utilisez le React/Tailwind existant du projet uniquement si le projet de l'utilisateur l'utilise déjà.
  • Recettes de mouvement : references/motion-and-effects.md. GSAP à partir d'une version cdnjs épinglée.
  • Gardez le code léger : aucune bibliothèque ou abstraction dont la mise en page n'a pas besoin.
  • Responsive à 1440 / 768 / 390, états de focus visibles, prefers-reduced-motion respecté.
  • Re-lisez references/anti-ai-slop.md pendant la construction — en particulier les lignes sur les bandes vides et le buffet de sections.

5. Vérifier visuellement

Rendez et comparez côte à côte avec la référence et le brief du site. Utilisez un outil de navigateur lorsqu'il est disponible (acheminé par C). Exécutez le protocole de vérification dans references/quality-bar.md : captures d'écran pleine page à 1440 / 768 / 390, ordre des sections et présence du contenu, pas de bande vide ou de texte tronqué, pas de défilement horizontal, contraste en pixels réels, focus clavier, mouvement réduit et erreurs de console. Vérifiez la hiérarchie, le rythme d'espacement, la cohérence des rayons/ombres, la densité et la langue. Cycles de correction : 1 lorsque la verbosité est terse, jusqu'à 3 lorsque full ; corrigez la plus grande différence visuelle en premier et arrêtez-vous lorsque la liste de contrôle est réussie.

6. Répondre

Formatez selon la verbosité de C. terse : 3–5 lignes — ce qui a été construit, les preuves utilisées, le résultat de la vérification. full : listez également les traits de référence pris d'où, les compétences utilisées/ignorées et une prochaine modification suggérée. Suivez les critères de transfert dans references/quality-bar.md, énoncez les limites connues une fois, et écrivez toujours dans la langue de l'utilisateur.

Utilisation d'autres compétences

L'agent C décide cela par exécution ; vérifiez d'abord ce qui est réellement disponible dans la session. Compétence manquante → utilisez le fallback et mentionnez-le une fois à la fin.

PhaseSi C dit utiliserFallback
Plan / direction de conceptionImpeccable (/impeccable shape, puis craft) ; exécutez son étape de contexte une fois par sessionfrontend-design, ou le plan de l'étape 3
Révision et polissageImpeccable critique, polish, auditAuto-révision par rapport au contrat
Qualité du mouvementemil-design-eng pour l'assouplissement, la durée, les ressorts, le survol/la pressionreferences/motion-and-effects.md
Vérification visuelleBrowser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome) : capture d'écran à 3 largeurs, vérifiez la consoleDécrivez les vérifications et demandez une capture d'écran à l'utilisateur
Logo ou objet 3Dimg2threejs uniquement si la référence contient un objet 3D digne d'être reconstruit ; énoncez sa limite : une image ne peut pas révéler les côtés cachésSVG plat ou CSS
Garder le code petitponytail avant d'ajouter une dépendanceCSS simple + une timeline GSAP

N'appelez une compétence que lorsque sa phase s'applique. Une page d'atterrissage statique n'a pas besoin d'img2threejs.

Originalité et sécurité

  • Recréez les motifs, pas les ressources. Ne réutilisez jamais le logo, les illustrations, le nom de marque ou le texte exact d'une référence. Utilisez la marque de l'utilisateur et le contenu réel de A/B.
  • De nombreuses épingles pointent vers des kits UI commerciaux. Faites correspondre le style et la structure uniquement.
  • L'apparence d'une référence est un point de départ. Si elle nuit à l'utilisabilité (faible contraste, petite police), conservez l'ambiance, corrigez le problème et dites-le.

Fichiers

  • references/agents.md — les trois agents de découverte, schémas et budgets.
  • references/design-contract.md — modèle de fusion et porte verrouillée.
  • references/anti-ai-slop.md — symptômes et correctifs pour les mises en page génériques, empilées et vides.
  • references/quality-bar.md — définition professionnelle de "fait" et protocole de vérification.
  • references/pattern-transfer.md — empêche les images de référence de transplanter la même recette de héros dans des produits sans rapport.
  • references/polish-existing-site.md — flux de travail additif lorsque la tâche est d'élever une mise en page de production existante.
  • references/categories.md — bases de genre (viabilité minimale, pas de menus de sections).
  • references/style-dna.md — modèle de lecture de référence ; nécessite des preuves.
  • references/motion-and-effects.md — effets CSS et recettes GSAP.
  • assets/refs.json — liens de référence connus (nécessitent toujours une visualisation).

Skills associés