Communitygithub.com

V4TIME/V4SKILL

Créez des interfaces web qui ont l'air d'avoir été conçues par un humain, pas générées par une IA.

Qu'est-ce que V4SKILL ?

Cette compétence permet de concevoir des interfaces utilisateur web qui ne ressemblent pas à une sortie typique d'IA. Elle repose sur des principes de design anti-génération automatique, comme l'absence d'emoji comme icônes, l'absence d'ombres lumineuses sur les boutons, l'absence d'animations rebondissantes, et un contraste suffisant (WCAG AA). Le processus inclut l'utilisation de bibliothèques de design comme webmxerz pour obtenir des systèmes de design complets, et l'outil Impeccable pour vérifier les antipatterns techniques. La compétence est utile pour les développeurs travaillant avec Claude Code, Cursor, ou tout autre agent IA, sur des projets web où l'apparence soignée est cruciale. Elle s'applique à tous les frameworks (React, Tailwind, HTML/CSS vanille) en adaptant les principes plutôt qu'en copiant du code spécifique.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/human-first-ui

Demander à votre IA préférée

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

Documentation

Interface Conçue par un Humain en Priorité

Créez des interfaces qui ressemblent à ce qu'une personne avec du goût a conçues — pas un dump de template, pas une valeur par défaut d'IA. Cette compétence intègre les principes de design, les vérifications d'anti-patrons et les workflows d'outils utilisés lorsque l'utilisateur veut explicitement une interface qui ne semble pas générée par IA.

Quand l'utiliser

  • L'utilisateur dit que l'interface « a l'air d'avoir été faite par ChatGPT » ou « a l'air générée par IA »
  • L'utilisateur veut un look « minimal, premium, humain »
  • L'utilisateur mentionne Emil Kowalski, Impeccable, 21st.dev, webmxerz, ou des signaux de qualité de design similaires
  • Créer ou revoir une interface web où l'apparence compte

Principes fondamentaux

1. Pas d'icônes emoji

Les emoji utilisés comme icônes sont le signe #1 d'une interface générée par IA. Utilisez des étiquettes textuelles, des formes CSS simples, ou du SVG en ligne. Les emoji sont pour le contenu, pas pour l'habillage.

2. Pas d'ombres lumineuses sur les boutons

box-shadow avec des lueurs colorées (surtout de couleur d'accent) sur les éléments interactifs est une marque de fabrique des interfaces générées par IA. Utilisez uniquement des bordures plates et des changements d'état au survol.

3. Pas d'animations rebondissantes / à ressort

Points glissants, chargeurs rebondissants, effets de survol à échelle élastique — ce sont des décorations, pas des fonctions. Des transitions de survol subtiles (120-150 ms, ease) sont acceptables. Pas de rebond.

4. Pas d'écran de bienvenue avec cartes d'icônes

Un écran de bienvenue doit être un texte simple sur la page, pas une carte décorée avec des tuiles d'icônes et des boîtes d'indice présentées comme des cartes de fonctionnalités.

5. Contraste d'abord

Sur des fonds sombres, le texte atténué doit encore avoir un rapport de contraste de 4,5:1 (WCAG AA). Les valeurs par défaut courantes générées par IA comme #5a5a5a sur #0d0d0d échouent lamentablement. Testez avec Impeccable.

6. Taille de police minimale pour le corps : 14 px minimum, 16 px idéal

Les polices de 10-11 px sont réservées aux micro-étiquettes décoratives uniquement (en-têtes de section, horodatages, texte de statut en bas de page avec espacement des lettres). Le texte porteur de contenu doit être de 12 px ou plus, et le texte du corps doit être de 14 à 16 px.

7. Hiérarchie typographique claire

Utilisez moins de tailles avec des écarts plus grands. N'ayez pas 6 valeurs font-size différentes alors que 3 ou 4 étapes bien séparées suffiraient. Visez une séparation nette entre les tailles étiquette / secondaire / corps / titre.

8. Une seule couleur d'accent, de préférence chaude

Une seule couleur d'accent chaude (or/ambre) sur un fond neutre sombre semble intentionnelle et premium. Les dégradés violets/bleus sont la valeur par défaut de l'IA à éviter.

9. Mobile d'abord

Concevez pour le téléphone. Menus hamburger, barres latérales superposées, grandes cibles tactiles, texte lisible sans zoom. Ne construisez pas pour le desktop et ne le compressez pas.

Workflow

Étape 1 : Vérifier la bibliothèque de compétences

Avant de construire quoi que ce soit, vérifiez si webmxerz ou impeccable est disponible :

# WebMXERZ (intelligence de design : couleurs, typographie, styles, patrons UX)
ls ~/tmp/webmxerz/src/webmxerz/scripts/search.py 2>/dev/null && \
  python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<requête>" --domain <style|typographie|couleur|ux|produit|...> -n 5

# Si non cloné :
git clone https://github.com/nextlevelbuilder/webmxerz.git ~/tmp/webmxerz

Préféré : utilisez --design-system pour un système complet en une seule passe plutôt que des recherches par domaine :

# Système de design complet avec des réglages de design adaptés au projet
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<description>" \
  --design-system \
  --variance <1-10> \
  --motion <1-10> \
  --density <1-10> \
  -p <slug-du-projet> \
  -n 5

Persistez pour les projets multi-pages :

# Enregistrez MASTER.md (et éventuellement une substitution de page)
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<requête>" \
  --design-system -p <projet> --persist -o <répertoire-du-projet> [--page <nom-de-page>]

Ensuite, lorsque vous travaillez sur une page spécifique, vérifiez d'abord design-system/<projet>/pages/<page>.md — ses règles remplacent design-system/<projet>/MASTER.md.

Étape 2 : Rechercher une direction de design

# Trouver un style qui correspond à ce que l'utilisateur veut
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<description>" --domain style -n 3

# Trouver une typographie
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<ambiance>" --domain typographie -n 3

# Trouver une palette de couleurs pour le type de produit
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<type de produit>" --domain couleur -n 3

# Trouver des patrons UX
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<patron>" --domain ux -n 5

Adaptez les résultats à votre stack réel. Si le projet est en HTML/CSS/JS pur (pas React/Tailwind), extrayez les principes de design (couleurs, polices, espacements, patrons) et implémentez-les en CSS pur. Ne copiez PAS le code des composants React.

Étape 3 : Construire avec les principes

  • Choisissez UN style parmi les résultats de recherche qui correspond au goût de l'utilisateur
  • Choisissez UNE paire de polices
  • Choisissez UNE palette de couleurs (adaptez l'accent aux préférences de l'utilisateur)
  • Implémentez dans le stack réel du projet
  • Restez minimal : l'espacement et la typographie font le travail, pas la décoration

Étape 4 : Linter avec Impeccable

npx impeccable detect templates/ static/css/ 2>&1

Passez en revue chaque résultat. Corrigez ce qui est signalé. Code de sortie 0 = propre. Code de sortie 2 = contient encore des problèmes.

Étape 5 : Itérer avec l'utilisateur

Montrez le résultat. Si l'utilisateur dit que ça a toujours l'air généré par IA ou que ce n'est pas bon, demandez-lui spécifiquement ce qui cloche (une couleur, une taille, un espacement, un composant) et corrigez ce seul élément. Ne refaites pas entièrement le design sur la base d'un retour vague.

Pièges connus

  • Surcharger la décoration pour « corriger » l'aspect IA : Ajouter plus de décoration ne rend pas l'interface plus humaine — ça la rend décorée. La retenue est le signal.
  • Utiliser le code React de webmxerz dans un projet non-React : Les données de la compétence (styles.csv, couleurs.csv, typographie.csv, ux-guidelines.csv) sont indépendantes du stack et utiles. Ses exemples de composants React ne le sont pas. Extrayez les principes, sautez le code des composants.
  • Impeccable comme revue de design : Il détecte les anti-patrons techniques (contraste, tailles, hiérarchie). Il ne juge pas le goût, l'équilibre, ou si l'esthétique globale semble humaine. Utilisez-le comme une passe de lint, pas comme un substitut au jugement de design.
  • Composants 21st.dev dans des projets non-React : 21st.dev est un registre React + Tailwind. Ses composants ne fonctionneront pas dans des projets Flask/Jinja2/HTML vanille. Naviguez-y uniquement pour l'inspiration visuelle.
  • Valeurs de couleur figées issues des résultats de recherche : Les palettes des résultats de recherche donnent des valeurs hexadécimales comme points de départ, pas comme réponses finales. Adaptez la couleur d'accent à ce que l'utilisateur aime réellement.
  • Porter un système de design d'une autre source (Lovable, export Figma, CSS d'un autre projet) : Auditez toujours les tokens atténués/pâles/faible contraste (--text-faint, muted-foreground, texte secondaire) par rapport au WCAG AA sur votre fond réel. Les designers les définissent trop bas car ils semblent subtils dans un outil de design — sur un fond sombre réel, ils échouent aux vérifications de contraste pour un texte en dessous de 14 px. Remontez le texte atténué à au moins #8a8886 sur les fonds sombres avant de livrer.
  • Mises en page générées par Lovable comme points de départ, pas comme remplacements : Une mise en page Lovable vous donne une structure propre et un système de design, mais elle n'aura pas les fonctionnalités supplémentaires de votre projet (éditeurs de slots API, panneaux d'outils, bascules vocales, renommage de session, onglets de mémoire). Portez le design, gardez les fonctionnalités.

Fichiers de référence

  • references/impeccable-findings.md — Résultats du scan Impeccable de la session Sayip (ce qui a été trouvé, ce qui a été corrigé, comment exécuter)
  • references/webmxerz-quickref.md — Référence rapide pour les domaines de recherche webmxerz, les flags, les réglages de design, --persist, le contrat de raisonnement, et la palette dérivée de Sayip avec corrections de contraste
  • references/lovable-port-checklist.md — Liste de contrôle pour porter une mise en page générée par Lovable dans un projet existant (cloner, auditer les tokens, porter la structure, garder les fonctionnalités, linter, tester)

Compétences connexes

  • software-development:codebase-inspection — lorsque vous devez inspecter ce qui a déjà été construit avant de refaire le design
  • lovable-port — compétence de niveau classe pour porter des mises en page générées par Lovable dans des projets Flask/vanille existants

Individual skills in this repo

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

Skills associés