Communitygithub.com

direction-artistique-web

Montre à un agent comment diriger et construire une « direction artistique web » afin que le résultat concret soit un logo et une petite charte de marque. La procédure couvre la direction artistique web, les outils et le processus. À utiliser lorsqu'une nouvelle mission nécessite ce savoir-faire.

Qu'est-ce que direction-artistique-web ?

Cette compétence apprend à un agent d'IA à produire une direction artistique web complète, allant du concept jusqu'à la livraison d'un logo et d'une charte de marque minimale. Elle couvre la composition, les références, le rythme des sections, la typographie, la couleur, l'imagerie, le texte, et intègre une boucle de critique automatique. L'agent suit un processus en 8 étapes : définition du brief, consultation des leçons passées, recherche de références via le serveur MCP `design-refs`, rédaction d'un contrat de direction artistique, construction de la page (polices réelles, images vérifiées, contenu réaliste), capture d'écran avec détection automatique de défauts techniques, boucle de critique (via un agent spécialisé ou un agent généraliste), et clôture en listant les placeholders à remplir. Les outils principaux sont le serveur `design-refs` et le script de capture `shoot.mjs`. La compétence insiste sur les décisions concrètes plutôt que les ambiances, et rejette le « slop » (apparence générique d'IA). Elle fonctionne avec tout agent compatible (Claude Code, Cursor, Codex) capable d'appeler des outils MCP et d'exécuter des scripts Node.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TFFy1/web-art-direction/tree/HEAD/skills/web-art-direction

Demander à votre IA préférée

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

Documentation

Direction artistique web

Les composants décident si une page fonctionne. La composition décide si on s'en souvient. Cette compétence gère la composition : concept, premier écran, rythme des sections, typographie, couleur, imagerie et texte. Ensuite, un critique examine le résultat jusqu'à ce qu'il soit prêt à être livré.

Outils

Le serveur MCP design-refs expose refs_api et refs_run (mode code). Appelez refs_api une fois par session pour charger l'API. Si ces outils sont absents, dites à l'utilisateur que le serveur design-refs n'est pas connecté et orientez-le vers le README du plugin. Si DESIGN_REFS_DIR est défini, lisez plutôt refs/index.json, lessons.json et les images de ce dossier.

Chargez ces fichiers uniquement lorsque leur étape arrive :

Processus

1. Brief

Découvrez à qui s'adresse la page, ce qu'ils doivent croire, l'action unique, et quels actifs réels existent (logo, photos, produit, texte, prix). Si l'un de ces éléments manque et ne peut être déduit, demandez une fois, avec au plus trois questions. N'inventez jamais de clients, logos, avis, prix ou statistiques. Utilisez des espaces réservés marqués et listez-les à la fin.

2. Mémoire

Exécutez lessons.list() et lisez chaque leçon. Elles proviennent de critiques passées et sont contraignantes sauf si le brief en annule une. Citez les leçons qui s'appliquent à cette page.

3. Références

Dans un seul appel refs_run :

  • trois références de catégorie A issues de la catégorie de la page,
  • deux références de catégorie A choisies aléatoirement (Math.random) parmi d'autres catégories. Elles sont des challengers face au défaut de la catégorie,
  • deux références de catégorie C issues de la catégorie, comme exemples à éviter.

Regardez leurs premiers écrans. Mesurez le plus pertinent en direct avec refs.measure(url). Pour chacun, écrivez une ligne sur ce que vous en retirez : une décision, pas une disposition. Si l'utilisateur nomme des sites qu'il aime, faites d'abord refs.capture() et étiquetez-les.

4. Direction

Lisez moves.md. Notez :

  • L'ornière : la page que cette catégorie livre toujours, et la version anti-slop de celle-ci (ex. fond crème + serif + terre cuite). Les deux sont interdites sauf si le brief les impose.
  • Thèse : une phrase nommant l'idée unique que cette page possède.
  • Premier écran : un mouvement de premier écran et exactement ce qui se trouve où, à quelle échelle.
  • Sections : quatre à six mouvements de section dans l'ordre, avec le rythme (dense ou calme, conteneur, échelle) de chacune.
  • Typographie, couleur, imagerie : un mouvement typographique, une stratégie de couleur avec valeurs hexadécimales, et le plan d'imagerie avec sources réelles.

Placez ce contrat dans un commentaire HTML en haut de la page. Si une ligne ressemble à une ambiance au lieu d'une décision, ce n'est pas encore décidé.

5. Construction

Lisez page.md et slop.md, puis construisez le contrat avec un engagement total : polices réelles, images réelles (vérifiez que chaque URL se charge), texte réel. Utilisez la compétence ui-libraries-no-ai-look pour les composants interactifs. Corrigez d'abord le héros, puis tout ce qui se trouve en dessous.

6. Capture

node <ce-dossier-de-compétence>/scripts/shoot.mjs <page.html-ou-url> <dossier-de-sortie>

Ceci écrit desktop.jpg, des captures de bureau, mobile.jpg, mobile-full.jpg et report.json avec des indicateurs mécaniques (sourcils, texte dégradé, dégradés violets, rangées de cartes égales, expressions toutes faites, h1 timide, images cassées, débordement). Corrigez chaque indicateur que le brief ne justifie pas avant la critique.

7. Boucle de critique

Lancez le critique avec un contexte frais, jamais une fourche de cette conversation :

  • si le type d'agent web-art-director est disponible (livré avec ce plugin), utilisez-le ;
  • sinon, lancez un agent généraliste dont l'invite commence par le texte intégral de agents/web-art-director.md de ce plugin.

Envoyez-lui ces entrées :

  • le brief et les réponses de l'utilisateur,
  • le contrat,
  • le chemin de la page,
  • le dossier de captures et report.json,
  • les identifiants de référence de l'étape 3.

Il renvoie rebuild, fix ou ship, avec des correctifs ordonnés, et enregistre lui-même des leçons via lessons.add.

  • rebuild : revenez à l'étape 4 pour les zones nommées.
  • fix : appliquez tous les correctifs en un seul lot, recapturez, et renvoyez les nouvelles captures au même critique (continuez-le, n'en lancez pas un nouveau) pour un verdict.
  • Répétez jusqu'à ship, au maximum trois tours. Si le troisième tour n'est toujours pas ship, montrez à l'utilisateur les éléments ouverts et laissez-le décider.

Rapportez le mot exact du verdict du critique tel qu'il l'a écrit, jamais un mot plus doux.

8. Clôture

Dites à l'utilisateur :

  • la thèse,
  • le verdict final,
  • les leçons qui ont été ajoutées ou renforcées,
  • quels espaces réservés ont besoin de contenu réel.

Tableaux de bord et UI d'application

L'utilisabilité prime sur l'expression ici. Utilisez des mouvements uniquement pour l'identité de l'enveloppe (typographie, couleur, un détail signature). Laissez ui-libraries-no-ai-look piloter les composants et exécutez quand même les étapes 2, 6 et 7.

Skills associés