Communitygithub.com

omd:feel — Interface Feel, Quantifié

Applique ou audite les détails d'interface que l'industrie traitait au « feeling » en les transformant en règles chiffrées, issues de la philosophie de Jakub Krehel étendue aux HIG/Material/WCAG/DS tokens.

Qu'est-ce que omd:feel — Interface Feel, Quantifié ?

Ce skill transforme les détails d'interface (motion, espacement, typographie, contrastes, cibles tactiles, etc.) en règles quantifiées avec un niveau de provenance (SPEC, DS, CONV, OP, FOLK). Il hérite de la philosophie de Jakub Krehel « great interfaces are a collection of small things that compound » et l’étend avec les guidelines Apple HIG, Material Design, WCAG, les tokens de design system ainsi que les recherches de praticiens. Le skill propose deux modes : APPLY (injecter les règles dans le code) et AUDIT (vérifier le code existant et générer un rapport avec score et sévérité BLOCK/WARN/FYI). Il est compatible avec tous les projets web et UI (React/Vue/Angular/HTML pur) et s’intègre aux assistants comme Claude Code, Cursor, Codex. Il respecte la hiérarchie des tokens de marque (DESIGN.md prime), interdit l’invention de chiffres, et exige la gestion de `prefers-reduced-motion` pour l’accessibilité.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/nococn/omd-feel/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

Que fait omd:feel — Interface Feel, Quantifié ?

L'industrie traitait les détails d'interface au « feeling » (« cette vitesse là », « cette ombre là », « cet espace là »). Ce skill les transforme en nombres vérifiables, classés par source, pour appliquer et auditer. Il hérite de la proposition de Jakub Krehel "great interfaces are a collection of small things that compound" mais répond quel chiffre viser / quand c'est faux avec des valeurs numériques.

Insight clé : la qualité est l'intégrallle de dizaines de petites contraintes maintenues dans leur bande respective. Un tick de checkbox à 600 ms, un focus ring de 1 px, un contraste de 2,85 :1, un hover lift sans @media (hover:hover) — chaque détail "feel" est une pénalité mesurable. Ce skill empêche ces pénalités.

Les 113 règles (17 axes) sont dans reference.md, la provenance (tier, méthode) dans provenance.md. La cheat-sheet ci-dessous est toujours chargée ; pour un audit profond, lisez la référence.

Quand l'utiliser

  • APPLY — Injecter des règles quantitatives de feel lors de la création ou modification d'UI. ("améliore le feel", "retouche les interactions", "applique les détails")
  • AUDIT — Vérifier du HTML/JSX/TSX/CSS existant contre la grille de règles et produire un rapport feel-score + BLOCK/WARN/FYI. ("vérifie le feel", "audite cet écran")

Ne se déclenche pas si ce n'est pas du travail UI. Les tâches de copie ou d'architecture de l'information ne sont pas ciblées.

0. Niveau de provenance → Force d'application (le cœur du skill)

Chaque règle porte un tier qui définit sa force d'application. C'est ainsi que le « feeling » devient honnête : les chiffres de spec sont des portes, ceux des goûts sont des suggestions.

BadgeTierAPPLYSévérité AUDIT
🟢 SPECspec-authoritative (W3C/WCAG·HIG·normative)ForcéBLOCK
🟢 DSds-token (jetons du système de design commits)Forcé (si la marque n'écrase pas)BLOCK
🟡 CONVindustry-convention (≥2 praticiens indépendants)Appliqué par défautWARN
⚪ OPsingle-opinion (1 personne de confiance)Suggestion seulementFYI
⚪ FOLKfolklore-unverified (source introuvable)Suggestion + tier explicitéFYI

Distribution : SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113 basés sur spec ou token (forçables).

DESIGN.md a toujours le dernier mot. Si un jeton de marque DESIGN.md entre en conflit avec une règle, le jeton de marque prime. Ces règles sont les valeurs par défaut quand la marque se tait, pas un override. Si un DESIGN.md existe à la racine du projet, omd:apply le lit d'abord et ne remplit que les axes vides avec les règles feel.

1. Cheat-sheet — Les chiffres clés toujours appliqués

Notation du tier : 🟢=forcé, 🟡=par défaut, ⚪=suggestion. En conflit : DESIGN.md > 🟢 > 🟡 > ⚪.

Motion & Timing

  • Transition UI courante ~200 ms (hover ≤150 ms · popover ~200 ms · overlay/modal ~300 ms). Plage 150–300 ms, >400 ms = lent. 🟡
  • Durée quantifiée par grille de 50 ms (interdit 220/333 ms). 🟢
  • exit ≈ 0,8 × enter (plus rapide en fermeture). 🟢
  • Interdiction d'une durée globale unique — proportionnelle à la zone/distance de déplacement. 🟢

Easing & Springs

  • enter/déclenché par utilisateur = ease-out cubic-bezier(0,0,0.2,1) · exit = ease-in/accelerate · morph déjà visible = ease-in-out · spinner/progress = linear. Interdiction de ease-in pour les entrées. 🟡
  • Apple = spring par défaut (response 0.55, damping 0.825, bounce 0), UI fonctionnelle : bounce <0,4. 🟢
  • Interruptible : les états interactifs utilisent transition/spring (reciblage possible), les animations one-shot uniquement @keyframes. 🟢

Espacement · Rayon · Rythme

  • Base 8 px, demi-pas 4 px (4·8·12·16·24·32·40·48·64). 🟢
  • Padding interne ≤ gap externe entre frères. 🟡
  • Rayon concentrique : outer = inner + padding. 🟢
  • Échelle typographique UI ~1,25 (major third). 🟡

Ombre & Profondeur

  • Ombres superposées 3–5 couches, une seule source lumineuse en haut. Basse altitude : serré+net, haute altitude : diffus+étalé (rampe Tailwind md→lg). 🟡/DS
  • Mode sombre : la profondeur se fait par surfaces claires plutôt que par ombres. 🟡

Typographie

  • Corps de texte line-height 1,5, measure ~66ch (45–75). 🟢
  • Tracking display −0,02 à −0,03 em, tout en majuscules +0,05 à 0,1 em, corps ~0. 🟡
  • Chiffres variables : tabular-nums ; titres text-wrap: balance, corps pretty ; disposition antialiased. (seed/jakub) 🟡

Couleur & Contraste

  • Texte 4,5 :1 (grand 3 :1) AA · non-texte/bords UI 3 :1 · focus ring 3 :1 + 2 px + ~2 px offset. 🟢
  • Couches d'état M3 : hover 8% · focus 10% · pressed 10% · dragged 16%. 🟢
  • Désactivé ~38% d'opacité. 🟡

États & Retours

  • Composants de données : 5 états (empty/loading/error/content/skeleton) tous définis. 🟡
  • Pressed : scale 0,96–0,97, 150 ms ease-out (sol 0,95). DS/⚪
  • Changement d'état d'icône : scale+opacity+blur 4 px→0, spring ~0,3. 🟡

Cibles & Pointeur

  • Cibles tactiles 44 pt (iOS/WCAG AAA) / 48 dp (Material) / 24 px (WCAG AA min), espace entre cibles ≥8 pt. 🟢
  • Curseur : interactif=pointer · inactif=not-allowed · glisser=grab→grabbing · édition=text. 🟡

Défilement & Gestes

  • Superpositions/défilements imbriqués : overscroll-behavior: contain (bloque le chaînage de défilement et le PTR). 🟢
  • Seuil de libération du swipe ~30% distance ou vélocité flick. DS
  • scroll-snap : formulaire long=proximity · carrousel=mandatory. 🟢

Temps de réponse & Performance perçue

  • 100 ms = instantané · 1 s = limite du flux de pensée · 10 s = limite d'attention (afficher % de progression). Plafond Doherty 400 ms. 🟢
  • INP ≤200 ms p75, budget trame 16,6 ms. 🟢
  • Spinner uniquement si attente prévue >1 s ; si affiché, maintenir au moins 500 ms (éviter le scintillement). Si la disposition est connue, utiliser skeleton. 🟡/DS

Stabilité de disposition (CLS)

  • CLS ≤0,1 p75. Réserver l'espace des médias avec width/height ou aspect-ratio. scrollbar-gutter: stable. font-display: optional (ou swap) + metric override. Interdiction d'insérer du contenu en haut en dehors de la fenêtre de 500 ms après une entrée. 🟢

Modales · Superpositions · Z-index

  • role=dialog + aria-modal=true, focus sur le dialog à l'ouverture, Tab trap, fermeture par Esc, restauration du focus sur le déclencheur à la fermeture, arrière-plan inert. Scrim #000 ~32%. 🟢
  • light-dismiss : activé pour les dialogues temporaires/informatifs, désactivé pour les saisies de données/actions destructrices. 🟢
  • Échelle z : dropdown 1000 / sticky 1100 / fixed 1200 / backdrop 1300 / modal 1400 / popover 1500 / toast 1600 / tooltip 1700. Les superpositions utilisent portal. (gap-fill)

Performance · Verre · Accessibilité

  • Les animations utilisent uniquement transform/opacity(+filter), interdiction de transition: all ; will-change est transitoire (supprimé au repos). 🟢
  • Verre : backdrop-filter: blur(16px) saturate(180%) + remplissage semi-transparent ~0,6 + 1 px hairline + fallback opaque, texte ≥4,5 :1. 🟡/🟢
  • prefers-reduced-motion: reduce → cross-fade/transition immédiate, supprimer les grands déplacements/parallax (petite opacité conservée). ≤3 flashs/s. Interdiction de supprimer le focus outline sans alternative (:focus-visible). 🟢

Validation de formulaire

  • Validation primaire au blur, puis passage à on-change (live) pour les champs déjà en erreur (l'erreur disparaît dès la correction). Debounce de validation asynchrone 300–500 ms. 🟡

2. Workflow APPLY

  1. Détection du contexte — Y a-t-il un DESIGN.md à la racine du projet/dossier cible ? Si oui, lire d'abord les jetons (couleur·rayon·espacement·motion·type) via omd:apply. Les jetons de marque = autorité.
  2. Remplir les axes vides — N'utiliser la cheat-sheet que pour les axes où DESIGN.md se tait. Pour les axes profonds (physique de scroll·verre·échelle z·CLS), se référer à la section correspondante de reference.md.
  3. Respecter le tier — 🟢 s'applique tel quel, 🟡 est la valeur par défaut (cède si la marque/la demande l'écrase), ⚪/FOLK est signalé comme « c'est une heuristique de goût » et seulement suggéré.
  4. Laisser une trace de la source — Pour les chiffres non triviaux (ex : exit 0,8×, focus offset 2 px), indiquer le pourquoi + le tier dans un commentaire de code ou une explication. Ne pas inventer de chiffres — s'il ne figure pas dans la cheat-sheet/référence, lire la référence ou dire qu'on ne sait pas.
  5. Toujours accompagner prefers-reduced-motion — si on ajoute du mouvement, ajouter la branche reduce (l'accessibilité n'est pas une option).

3. Workflow AUDIT

Modèle advisory (lecture seule) comme omd:designer-review + axe feel. À chaque appel, relire DESIGN.md (pas de cache).

  1. Entrée : artifact_path (HTML/JSX/TSX/CSS) + (si existe) design_md_path + viewport.
  2. Scan machine_check — Appliquer chaque règle 🔍 machine_check de reference.md à l'artefact. Ex :
    • Détecter transition: all / duration >400 ms / duration hors grille
    • Cibles tactiles <44 px, focus outline supprimé, contraste texte <4,5 :1
    • <img> sans aspect-ratio, modal sans aria-modal, superposition sans overscroll-behavior
  3. Mapping sévérité = tier — Violation SPEC/DS = BLOCK, CONV = WARN, OP/FOLK = FYI. (Interdiction d'inflater ou déflater la sévérité.)
  4. feel-score — Ratio des axes applicables dans la bande : 🟢 in-band / 🟢 applicable comme chiffre clé, WARN/FYI secondaires. Exemple : "feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5".
  5. Sortie : <work_dir>/.reviews/feel-audit-round-<N>.md — chaque problème avec réf ligne + tier + preuve machine_check + correctif (actionnable). Interdiction de problèmes sans réf ligne ou de validation "looks good" sans valeur.
### [BLOCK] Cible tactile insuffisante — bouton icône
- **Emplacement :** `components/Toolbar.tsx:31`
- **Règle :** §8 Cibles — 44pt/48dp/24px min (🟢 SPEC, WCAG 2.5.8)
- **Preuve :** `<button className="w-6 h-6">` → 24px, pas de hit-slop
- **Correctif :** Assurer une région de hit 44×44 via du padding (`p-2.5` + icône visuelle 24px conservée)

4. Garde-fous

  • ❌ Interdiction de présenter du folklore comme une spec. ⚪/FOLK doit toujours expliciter son tier. (La liste demote du corpus Appendix B — Hick-Hyman 0.155s/bit, Fitts ms/bit, rubberband 0.7, pressed 0.95 sol, exit 0.8×, stagger 80/100ms, optical 2px, etc. — ne pas forcer comme portes numériques, n'emprunter que la direction.)
  • ❌ Interdiction d'inventer des chiffres. S'il n'est pas dans la cheat-sheet/référence, lire la référence ou dire "je ne sais pas".
  • ❌ Interdiction d'ignorer DESIGN.md et d'écraser avec des best-practices générales. Les jetons de marque passent en premier.
  • ❌ Interdiction d'ajouter du mouvement sans branche prefers-reduced-motion.
  • ❌ Interdiction dans AUDIT d'inflation de sévérité (tout en BLOCK), de déflation (BLOCK en FYI), ou de problèmes sans réf ligne.
  • ❌ Si un chiffre doit être modifié, ne pas modifier manuellement reference.md mais régénérer via corpus → générateur.

5. Relations avec l'écosystème omd

  • omd:apply — Applique les jetons de marque DESIGN.md. omd:feel remplit par-dessus la couche sensation là où les jetons se taisent.
  • omd:designer-review — Audite la cohérence de marque (budget typo/couleur/échelle rayon). L'AUDIT d'omd:feel en est le compagnon d'axe feel (motion·cibles·CLS·a11y).
  • omd:taste — Tableau de bord des goûts utilisateur (concept distinct). Si une décision feel se répète et devient un goût, la transmettre à omd:remember.

Validation manuelle : AUDIT sur un composant comportant transition: all 0.6s + <button class="w-5 h-5"> + absence de branche prefers-reduced-motion doit produire au moins 3 BLOCK (transition all=GPU SPEC, cible 20px=WCAG SPEC, absence reduced-motion=a11y SPEC) avec réf ligne et un feel-score réduit en conséquence.

Skills associés