Communitygithub.com

fresh-eyes

Crée et révise les interfaces utilisateur d'applications web (écrans, tableaux de bord, paramètres, tableaux, formulaires, intégrations, états vides et d'erreur, ainsi que les pages d'atterrissage, d'accueil et de tarification) pour qu'elles paraissent conçues par une personne réfléchie, et non par un modèle. Chaque écran est construit à partir de la tâche de l'utilisateur et du contenu réel, vérifié par rendu et par un regard neuf, mesuré selon WCAG 2.2 AA, et exempt d'artefacts artificiels.

Qu'est-ce que fresh-eyes ?

fresh-eyes est un ensemble de compétences pour agents d'IA (compatible avec Claude Code, Cursor et autres) dédié à la conception et à la révision d'interfaces utilisateur d'applications web. Il guide l'agent à travers sept étapes : comprendre l'utilisateur et son contexte, décider de la structure avant le style, rédiger le contenu textuel en priorité, construire l'interface avec les composants du projet, effectuer un rendu avec captures d'écran et vérifications automatisées (contraste, cibles tactiles, etc.), soumettre l'écran à un regard neuf (via un sous-agent ou une auto-évaluation), puis corriger et finaliser. L'outil inclut des scripts Node.js pour l'analyse des tokens de couleur et le rendu avec Playwright, ainsi qu'un ensemble de documents de référence couvrant la structure, la hiérarchie, la clarté, les états, le contenu textuel, le savoir-faire technique, le design moderne, les artefacts, les pages de conversion et l'accessibilité WCAG 2.2 AA. Il se distingue par son refus des données inventées, son accent sur le contenu réel, et une boucle de validation qui garantit que l'interface sert réellement la tâche de l'utilisateur sans artifices ni bruit visuel. Son utilisation est recommandée pour toute tâche de création, révision, refonte ou audit d'écrans d'applications SaaS ou de sites web, qu'il s'agisse de pages, de composants ou de systèmes visuels complets.

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

Fresh eyes

Concevez l'écran pour la personne qui l'utilisera, à partir de la tâche qu'elle vient accomplir et du contenu qu'elle verra. Le jugement guide ; les références l'affinent et les scripts le vérifient. Rien ici ne prime le bon sens : si un écran est confus et qu'aucune règle ne le nomme, il reste confus.

<skill> ci-dessous correspond au répertoire de cette compétence : ${CLAUDE_SKILL_DIR} (si cela s'affiche comme une variable littérale, utilisez le dossier à partir duquel ce fichier a été lu).

Configuration

Les scripts nécessitent Node 20 ou ultérieur. Lorsqu'un script indique qu'il nécessite une configuration, exécutez ce qu'il affiche : une ou les deux commandes suivantes : npm --prefix "<skill>" install et node "<skill>/node_modules/playwright/cli.js" install chromium, qui fonctionnent depuis n'importe quel dossier et dans n'importe quel shell.

Si les scripts ne peuvent pas s'exécuter ici (pas de shell, pas de Node, pas de réseau pour le téléchargement du navigateur), ne vous arrêtez pas : prenez des captures d'écran avec l'outil de navigateur disponible dans la session, ou vérifiez le code ligne par ligne par rapport à references/floor.md, et mentionnez dans le rapport que la vérification par rendu n'a pas été effectuée. Ne signalez jamais une vérification visuelle effectuée à partir du seul code.

La boucle

Utilisez-la pour créer et pour réviser. Pour une révision, lisez d'abord references/review.md : ses étapes remplacent les étapes 1 à 4, et la version améliorée est une copie à côté de l'originale, sauf si la personne a demandé que ses fichiers soient modifiés.

  1. Comprendre. Qui utilise cet écran, pour quelle tâche, à quelle fréquence, sur quel appareil, avec quel contenu réel. Lisez le fichier DESIGN-CONTEXT.md du projet s'il existe (references/design-context.md). Sinon, déduisez-le du code, du texte et de la demande, et notez vos hypothèses. Ne vous arrêtez pas pour interroger d'abord l'utilisateur.
  2. Décider avant le style. Notez brièvement, dans vos notes de travail ou la réponse, avant de construire : l'unique objectif de cet écran ; ce que l'œil doit voir en premier ; ce que le premier écran doit contenir pour la décision principale, sur ordinateur et sur téléphone ; l'ordre de tout le reste ; la seule action principale ; ce que vous laissez de côté. Nommez deux ou trois produits que les utilisateurs de cette catégorie apprécient déjà, dont vous suivez les structures, et le geste signature que ce produit possède (references/modern.md). C'est votre intention, et l'étape 6 la teste.
  3. Écrire les mots d'abord. Titres, libellés, boutons, états vides et d'erreur, avec les mots de la personne, à partir des données réelles (references/words.md). N'inventez jamais de chiffres, de noms, de témoignages ou de tendances ; sans données réelles, utilisez un espace réservé visible.
  4. Construire dans l'ordre : la structure, puis la hiérarchie, puis le savoir-faire, avec les composants et les tokens du projet lorsqu'il en possède (pour React avec shadcn/ui, lisez references/stacks/react-shadcn.md). Un nouveau système visuel commence par node "<skill>/scripts/tokens.mjs" --accent "<hex>" --out <dir>, qui vérifie chaque paire de couleurs.
  5. Rendre et observer. Pour une application, démarrez son serveur de développement et passez l'URL. Écrivez --out vers un dossier temporaire à l'extérieur du projet : node "<skill>/scripts/render.mjs" <page.html | url> --out <dir> (s'il demande une configuration ou ne peut pas s'exécuter, voir Configuration) ; derrière une connexion, ajoutez --storage-state <file>. Il enregistre les captures d'écran desktop et mobile, en mode clair et sombre, affiche les problèmes qu'il peut mesurer (contraste, focus, défilement latéral, petites cibles, boutons primaires concurrents, bandes de bordure, tirets em), puis une liste de « vérification visuelle ». Corrigez chaque problème, ou indiquez dans le rapport pourquoi l'un d'eux persiste ; une révision corrige les problèmes de base, les bandes et les tirets em, et propose les autres indicateurs mesurés comme constats. S'il avertit que le mode clair et sombre semblent identiques, relancez avec --theme-mode class. Regardez les captures d'écran, les quatre -first.png en premier, et chaque élément de la « vérification visuelle » : une liste vide signifie que les bases sont propres, pas que l'écran est bon. Rendez une fois avec un contenu extrême : le nom réel le plus long, la plus grande quantité, le compte vide.
  6. Regard neuf. Démarrez un nouveau sous-agent qui n'a rien de cette conversation (pas une fourche) ; utilisez le type d'agent first-look s'il est répertorié. Son invite complète : Lisez <skill>/agents/first-look.md et suivez-le. La tâche : <une phrase>. Images : <chemins absolus, ceux du premier écran en premier>. N'ouvrez aucun autre fichier. N'ajoutez rien concernant votre intention ou ce que vous avez construit ou modifié. Comparez ses réponses avec l'étape 2 : un mauvais « qu'est-ce que c'est », un mauvais premier clic, une hésitation ou un « ça cloche » est une correction ; dans une révision d'une page qui fonctionne déjà, une hésitation qui ne bloque ni n'égare la tâche est une suggestion optionnelle, pas une correction. Sans sous-agents, répondez vous-même aux questions du premier regard à partir des seules images du premier écran, avant de relire votre code.
  7. Corriger et s'arrêter. Corrigez chaque hésitation d'abord par la structure (un libellé, une liste, un visuel, un regroupement) ; n'ajoutez une phrase que lorsque rien d'autre ne peut la porter. Un doute sur un nom est corrigé par un meilleur nom, jamais par une ligne d'explication en dessous, et rien n'est jamais expliqué à l'intérieur d'un menu. Au maximum deux autres cycles des étapes 5 et 6, puis nommez ce qui reste ouvert. Répondez aux trois questions du test dans references/modern.md (quel produit de la catégorie appellerait cela actuel ; où se trouve la signature ; cela pourrait-il appartenir à n'importe quelle startup), et faites le rapport.

Le chemin le plus simple d'abord. L'action principale fonctionne dès l'ouverture de l'écran ; les capacités supplémentaires (modifier chaque ligne, outils en masse) se trouvent un niveau en dessous, jamais sur le chemin du premier écran (references/structure.md).

Fini, pas nu. Éviter les artefacts n'est pas le but. Un écran doit ressembler à un produit fini : des unités sur lesquelles la personne agit dans leurs propres conteneurs, des icônes et de petits visuels là où ils portent du sens, l'ensemble de la décision sur le premier écran. Une large colonne de phrases grises est aussi un échec (references/hierarchy.md).

Adaptez à la demande. Uniquement des mots (libellés, message d'erreur) : étapes 1 à 3. Un composant ou une petite correction : étapes 1 à 5. Un écran complet ou une révision : les sept étapes.

Les questions qui décident de la plupart des écrans

DemandezLisez
Qui vient ici, à quelle fréquence, pour quelle tâche ? Quelle densité doit-il y avoir (posture) ? Comment les choses sont-elles regroupées, nommées et accessibles ?references/structure.md
Que doit voir l'œil en premier ? Y a-t-il exactement une action principale ? Chaque nombre a-t-il sa comparaison, son unité et sa date ?references/hierarchy.md
Un débutant peut-il dire ce que c'est, où il est et quoi faire ensuite ?references/clarity.md
Dans quel état se trouve chaque région, et est-ce exactement un ? Quand quelqu'un se trompe, annuler ou confirmer ?references/states.md
Les mots nomment-ils les choses comme la personne le fait ? Chaque erreur dit-elle la correction ?references/words.md
La typographie, l'espacement, la couleur, le mode sombre et le mouvement sont-ils délibérés ?references/craft.md
Cela a-t-il l'air fini, ou comme un document ? Le premier écran contient-il la décision ?references/hierarchy.md
Cela a-t-il l'air actuel sans sembler généré ? Quelle est sa signature ?references/modern.md
Cet écran pourrait-il appartenir à n'importe quel produit ? Qu'est-ce qui peut le quitter ?references/tells.md
S'agit-il d'une page d'atterrissage, d'accueil ou de tarification ? Que doit décider un visiteur ?references/landing.md
Clavier, contraste, réaffichage, noms, cibles, dans les deux thèmes ?references/floor.md

Lisez une référence lorsque sa question est ouverte sur l'écran devant vous, pas toutes d'un coup. Chaque fiche contient une Décision, un À faire, le Pourquoi avec sa source, ce qu'il faut Rechercher, et quand elle ne s'applique pas (Sauf si). Les exceptions comptent autant que les règles.

Lignes qui ne bougent pas

  • Contenu réel uniquement : pas de chiffres, de personnes, de citations ou d'histoires inventés.
  • Le socle d'accessibilité (references/floor.md) tient en mode clair et sombre.
  • Pas de bande colorée sur un bord d'un élément comme accent, et pas de tirets em dans le texte (references/tells.md).
  • Dans une révision, conservez chaque donnée et chaque action que la page avait ; déplacez ou rétrogradez, ne supprimez pas.
  • « Aucun changement nécessaire » est une révision complète lorsque rien ne coûte quoi que ce soit à la personne. Ne changez jamais pour le simple goût.

Rapport

Des mots simples, courts :

  • ce que vous avez construit ou modifié, chaque élément lié à la tâche de la personne et à ce qu'il lui épargne ; dans une révision, chaque changement, aussi petit soit-il (une taille, un écart, une couleur), par exemple sous forme d'un court tableau « était », « maintenant » et « ce que cela épargne à la personne » : un changement que vous ne nommez pas est une promesse non tenue ;
  • ce que vous avez supposé, au maximum trois éléments, et ce qui changerait si une hypothèse est erronée ;
  • ce que vous avez vérifié : les problèmes de rendu avant et après, et comment le premier regard s'est comparé à votre intention ;
  • ce que vous n'avez pas testé (gestes, un vrai téléphone, Safari, un lecteur d'écran), et si le rendu a été exécuté.

Pas de scores, d'identifiants ou de numéros de règle. Si le projet n'a pas de fichier DESIGN-CONTEXT.md, proposez d'en écrire un à partir de vos hypothèses.

Skills associés