Communitygithub.com

interface-feel

À utiliser lorsqu'une application ou un site doit sembler plus soigné, plus rapide ou plus premium, pour auditer et corriger les sensations d'interface, les animations, les transitions ou la qualité des interactions, ou pour appliquer des lois UX, des principes d'animation et des astuces d'interface (Fitts, Hick, Doherty, mises à jour optimistes, squelettes, menu de commandes, toasts d'annulation, zone de clic élargie, triangle de sécurité, transitions de vue) à un projet web ou mobile.

Qu'est-ce que interface-feel ?

Cette compétence effectue une passe maîtresse sur la sensation d'interface d'une application web ou mobile. Elle audite le comportement actuel de l'application par rapport à quarante critères (douze principes d'animation, huit lois UX, vingt techniques d'interface) et un système de mouvement, génère un rapport, puis corrige chaque problème selon le modèle approprié. La plupart des applications possèdent déjà la moitié de la liste ; l'audit le constate pour éviter les duplications. La rapidité, les cibles et la confiance sont toujours applicables ; la décoration est restreinte dans un outil de travail. La compétence s'appuie sur le propre système de design, les tokens de mouvement et les règles du projet. Elle exécute trois passes : un audit sans modification (recensement du code, sondes de page en direct, inspection manuelle), une correction basée sur une liste de vérification (items de construction et de sélection), et une vérification par re-recensement et nouvelle sonde. Elle évite les erreurs courantes comme l'ajout de fonctionnalités existantes, une déduplication côté client insuffisante, ou le jugement des performances sur un serveur de développement.

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

Sensation d'interface

La passe maîtresse pour la manière dont une interface bouge et réagit. Elle audite ce que fait l'application aujourd'hui par rapport à quarante éléments (douze principes d'animation, huit lois UX, vingt techniques d'interface) et un système de mouvement, rédige un rapport, puis corrige chaque constatation selon le modèle de cet élément. La plupart des applications possèdent déjà la moitié de la liste ; l'audit le constate pour éviter de l'ajouter deux fois. La rapidité, les cibles et la confiance s'appliquent toujours ; la décoration est restreinte dans un outil de travail.

Le propre système de design, les tokens de mouvement et les règles du projet priment sur tout ce qui se trouve ici. Les budgets de performance (LCP, INP, taille du bundle), l'accessibilité et le contenu rédactionnel font l'objet de leurs propres passes en dehors de celle-ci.

Fichiers de cette compétence

FichierUtilisation
reference.mdchacun des 40 éléments : comment le vérifier, le modèle de correction, quand l'ignorer, ce qu'un audit réel a trouvé
motion.mdle système de mouvement : tokens, douze règles, motifs CSS, comment auditer le mouvement
audit/census.shrecensement du code : compte les motifs derrière chaque élément, avec des indications fichier:ligne
audit/probe.jssonde de page en direct : cibles réelles, durées, easings, chiffres, titres, champs de code, espaces réservés
report-template.mdle modèle de rapport d'audit : une ligne de verdict par élément, ordre de travail, ce qui n'a pas été vérifié

Passe 1 : audit (ne rien changer)

  1. Lisez d'abord le système de design, les tokens de mouvement et les règles d'interface du projet.
  2. Exécutez le recensement depuis la racine du projet : bash <ce skill>/audit/census.sh . --show 5. Il lit uniquement la surface livrée (les dépendances, les builds, les copies vendorisées, les tests, les bancs d'essai, les fichiers générés et les lignes de commentaires sont exclus ; ajoutez-en avec CENSUS_EXCLUDE="dir1,dir2"). Installez ripgrep pour une exécution rapide ; sans lui, le script utilise perl comme solution de repli. Un compte est une piste à ouvrir, pas un verdict.
  3. Exécutez l'application. Sur chaque page clé, exécutez audit/probe.js (collez-le dans la console, ou utilisez await dans l'exécuteur JavaScript d'un outil de navigateur) à 1440 de large et à 375, dans chaque thème de l'application. Il fait défiler toute la page écran par écran et restaure la position. Un onglet caché n'a pas de largeur et ne peint aucune image : affichez-le d'abord. Lisez sa sortie avec discernement : une cible marquée spaced (son espacement avec la commande suivante atteint le seuil minimum) est de gravité moindre ; les chiffres n'ont besoin de tabular-nums que lorsqu'ils changent ; marquez les fenêtres factices décoratives aria-hidden ou ignorez leurs lignes.
  4. Pilotez manuellement ce qu'aucun script ne peut voir, avec de vrais événements de pointeur (un clic d'outil de navigateur, pas un .click() synthétique) : appuyez deux fois rapidement sur chaque action payante ou irréversible et comptez les effets serveur ; limitez le réseau et une écriture à 600 ms et appuyez ; ouvrez et fermez rapidement chaque couche et rouvrez-la en plein milieu de la sortie, en échantillonnant son opacité (motion.md, « Mesurer une réouverture ») ; appuyez à l'intérieur d'un menu en cours de fermeture ; tapez une requête accentuée et une requête avec une casse différente ; déplacez-vous en diagonale vers un sous-menu au survol ; touchez Retour Android avec une couche ouverte ; balayez une feuille de téléphone.
  5. Rédigez le rapport à partir de report-template.md : les 40 lignes, chacune présente, manquante, erronée ou ignorer avec une raison, une preuve sous forme de fichier:ligne ou d'un nombre, et construire ou choisir. Montrez-le avant de corriger.

Passe 2 : corriger selon la liste de vérification

  1. D'abord la confiance : élément 39 et tout ce qui peut doubler un frais ou perdre des données, avec un test qui échoue avant la correction.
  2. Les éléments Construire changent le comportement sans nouvelle apparence (zone de clic élargie, triangle de sécurité, geste Retour, pliage d'accent, raccourcis, entrées de menu de commandes, écritures optimistes, squelettes, tokens de mouvement, transitions réversibles). Corrigez chacun selon son motif dans reference.md et motion.md, via les propres composants et tokens du projet, avec un test pour toute logique.
  3. Les éléments Choisir changent l'apparence ou le produit (coins, espaces réservés flous, annulation au lieu d'une confirmation, un battement d'erreur, un nouveau battement de mouvement, une transition de vue). Évaluez chacun avant et après à l'échelle 1 dans les deux thèmes, numérotés et séparables ; ne construisez que ce que le propriétaire choisit.
  4. Ne remplacez jamais une décoration supprimée par une nouvelle décoration.

Passe 3 : vérifier

Relancez le recensement et la sonde et comparez les chiffres avec le rapport. Pilotez chaque interaction corrigée comme le ferait un utilisateur, dans les deux thèmes, et séparément à la largeur d'un téléphone. Rapportez les éléments construits, testés, visuellement approuvés et déployés comme des faits distincts, et nommez ce qui n'a pas pu être mesuré (pas de téléphone physique, pas de build de production).

La liste de vérification

Les numéros correspondent à reference.md et au rapport.

#ÉlémentÉchec quand
APrincipes d'animation (motion.md)
1Écrasement et étirementun badge, point ou bouton d'atterrissage s'arrête net
2Anticipationune pression n'a pas d'état dans une trame (échelle d'environ 0,97, environ 100 ms)
3Mise en scèneune couche ouverte laisse l'élément principal incertain
4Pose à poseun bouton, une étiquette ou une icône chargé saute en largeur ou en contenu
5Suivile contenu d'une couche arrive soudé à son conteneur
6Ralentissement à l'entrée et à la sortielinear ou ease par défaut sur les animations d'interface ; plus de trois easings
7Arcsquelque chose se déplace loin en ligne droite
8Action secondaireune action terminée n'a pas de deuxième battement de confirmation
9Timing rapideune réponse d'interface de plus de 300 ms ; une surface différente de ses pairs ; les sorties ne sont pas plus courtes
10Retour exagéréune soumission invalide ne montre qu'une secousse, sans battement de couleur
11Dessin solideles ombres et les couches sont en désaccord sur la lumière et la profondeur
12Attraitun flux réel, parcouru pas à pas à l'échelle 1, montre un défaut
BLois UX
13Fittsune cible réelle de moins de 32 px sur ordinateur ou 44 px sur téléphone
14Zones de clic plus grandesdes cibles agrandies en augmentant la surface de l'image, ou des éléments frères qui se chevauchent
15Hickplus de cinq éléments dans un seul bloc de menu
16Millerplus d'environ sept éléments de premier niveau non regroupés
17Dohertypression jusqu'à la prochaine peinture de plus de 400 ms sans rien qui réponde d'abord
18Postelune variante d'accent, de casse ou d'espacement d'une requête ne trouve rien
19Jakobun motif se comporte différemment de sa plateforme (sous-menu au survol, Retour ferme une couche)
20Fréquence d'utilisationune action quotidienne est à plus d'une étape ou d'une commande de distance
CRapidité et retour
21Chargeurs squelettesune route peint un blanc ou un spinner sur la trame du clic
22Mises à jour optimistesune écriture réversible bon marché ne montre rien jusqu'à la réponse du serveur
23Menu de commandesune destination est accessible en cliquant mais pas en tapant
24Indices de raccourcisun contrôle avec un raccourci ne l'affiche pas dans son infobulle
25Toasts d'annulationune suppression restaurable n'a pas d'annulation (le propriétaire décide si elle remplace une confirmation)
26Stale-while-revalidateune page revisitée attend au lieu d'afficher ses dernières données
27Pré-renduune page suivante probable n'est pas préchargée sur intention (juger en production)
28Espaces réservés flousune image en chargement est une boîte grise
29Transitions de vueune ouverture de grille vers détail n'a pas de morphose d'élément partagé
30Balayer pour fermerune feuille ou un tiroir de téléphone ne peut pas être fermé par balayage
31Animations interruptiblesune réouverture pendant une sortie rejoue depuis zéro
DPlateforme et détail
32Retour prédictifRetour Android avec une couche ouverte quitte la page
33Zone de clic élargiedes petits contrôles d'icônes n'ont pas de croissance de cible invisible
34Incrustations de zones de sécuritéles flottants inférieurs ignorent env(safe-area-inset-*) sous viewport-fit=cover
35Saisie automatique de code à usage uniqueun champ de code manque autocomplete="one-time-code" et inputmode="numeric"
36Chiffres tabulairesdes chiffres changeants tressautent (pas de tabular-nums)
37Titres équilibrésun titre court sur plusieurs lignes laisse un orphelin (pas de text-wrap: balance)
38Coins continusles coins squircle ne sont pas pris en compte (une décision d'apparence : évaluez-le)
EConfiance
39Clés d'idempotencedeux pressions rapides d'une action payante ou irréversible produisent deux effets serveur
40Triangle de sécuritéun sous-menu au survol se ferme lors d'un déplacement diagonal vers lui

Erreurs courantes

  • Ajouter ce qui existe : les squelettes, la mise en cache et les tokens de mouvement sont souvent déjà présents ; le verdict est présent.
  • La déduplication côté client comme barrière financière : deux clics atterrissent avant qu'un rendu ne désactive le bouton. Protégez côté serveur (mise à jour conditionnelle, clé déterministe, verrou) et maintenez la pression dans une référence.
  • Agrandir l'image au lieu de la cible ; vérifier les cibles uniquement à la largeur du bureau alors qu'une règle de bureau élimine le seuil minimal du téléphone.
  • Des keyframes pour l'ouverture et la fermeture : elles ne peuvent pas être inversées. Utilisez des transitions sur un attribut d'état, et rendez une couche sortante inert.
  • Traiter l'annulation, les coins ou le son d'erreur comme des choix d'ingénierie. Ils appartiennent au propriétaire.
  • Juger le préchargement ou le timing sur un serveur de développement ou un onglet d'arrière-plan.

Skills associés