audit-ux-vidéo-timeline

Instrument universel pour détecter rapidement les problèmes, lacunes et opportunités dans n'importe quelle interface utilisateur. Enregistrez une courte session d'une personne l'utilisant, capturez chaque événement console, réseau et performance sur la même horloge que les images vidéo, et laissez une IA examiner l'ensemble de la timeline fusionnée en une seule fois. Le résultat est un fichier findings.md classé avec preuves et correctifs UX et performances.

Qu'est-ce que audit-ux-vidéo-timeline ?

Cette compétence permet de réaliser un audit UX complet et automatisé d'une interface utilisateur en enregistrant une courte session d'utilisation réelle (quelques secondes à quelques minutes). Elle synchronise sur une même horloge les images vidéo, les événements de la console, les requêtes réseau, les tâches longues et les décalages de mise en page, produisant une timeline fusionnée. Cette timeline, accompagnée d'images clés, est ensuite analysée par une IA multimodale en un seul passage pour identifier les problèmes (bugs, lenteurs, incohérences), les lacunes (chemins morts, retours manquants) et les opportunités d'amélioration (optimisations réseau, mise en cache, préchargement). Le résultat est un rapport classé par sévérité (P0 à P2) avec des preuves visuelles et des correctifs UX et performance. La compétence fonctionne via Chrome DevTools Protocol pour le web, et peut être adaptée à d'autres plateformes (iOS, Android, bureau, terminal) en utilisant le même format d'événements. Utilisez-la pour auditer une vue, une application ou un flux, comprendre pourquoi quelque chose semble cassé ou lent, avant une refonte, ou après une mise en production.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/serebano/video-ux-audit/tree/HEAD

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

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

Documentation

Audit UX vidéo + timeline

L'idée : quelques secondes à quelques minutes d'utilisation réelle contiennent déjà la plupart de ce qui ne va pas. Les problèmes passent inaperçus parce que personne ne voit tout à la fois : ce que la personne a tenté, ce que l'écran a montré, ce que le code a enregistré et ce que le réseau a fait. Cette méthode enregistre tout cela sur une seule horloge, de sorte que chaque image peut être expliquée par ses événements et chaque événement peut être vu dans son cadre. Une IA lit alors l'ensemble en un seul passage.

Résultats

FichierDescription
audit.mp4La session, avec des légendes incrustées : noir pour l'intention, rouge pour chaque problème
events.jsonChaque action, légende, message console, exception, requête (statut, ms, octets, échecs), tâche longue et décalage de mise en page, horodaté sur l'horloge vidéo
timeline.mdLa timeline fusionnée, plus les signaux automatiquement détectés, chacun lié à l'image où il s'est produit
ai-pack/Images clés nommées par le temps vidéo, timeline.md et PROMPT.md, prêts pour tout LLM multimodal à examiner en une seule fois
findings.mdLa liste finale classée : problèmes, lacunes et opportunités, chacun avec preuves, correctif UX et correctif performance

0. Sécurité

  • Utilisez des comptes et des données de test, et n'effectuez des écritures que dans un bac à sable. Les données utilisateur réelles sont en lecture seule.
  • Ne publiez jamais de noms, e-mails, numéros de téléphone, identifiants ou jetons. Nettoyez events.json (URL, texte de la console) avant de partager.
  • Utilisez un profil de navigateur jetable et fermez-le à la fin.

1. Cadrer la session (2 minutes)

  • Nommez une à trois tâches qu'un utilisateur réel vient accomplir, dans ses mots. Par exemple : « trouver la commande », « répondre au client », « changer mon abonnement ».
  • Choisissez la durée en fonction de l'interface : 10–60 s pour un écran, 2–5 min pour un flux complet. Des sessions courtes et ciblées sont meilleures que des sessions longues.

2. Agir comme une personne réelle et non technique

  • Dites ce que vous voulez faire avant chaque action (une légende say).
  • N'utilisez que ce qui est visible. Pas d'URL tapée, pas d'outils de développement, pas de raccourcis cachés.
  • Essayez d'abord le chemin évident. S'il échoue, c'est un constat, même si un autre chemin fonctionne.
  • Après chaque action, vérifiez que tout concorde : liste, compteurs, en-tête, autres panneaux et la vue de l'autre partie.
  • Stressez l'état. Rechargez, revenez en arrière, ouvrez dans un nouvel onglet, utilisez un réseau lent et utilisez la largeur d'un téléphone (390×844).
  • Notez les attentes. Si vous attendez, l'utilisateur attend.

Il y a deux façons de piloter :

  • Scénarisé. Un scenario.json d'étapes. Il est reproductible et le même fichier devient la preuve de régression après le correctif.
  • Libre. {"url": "...", "freeSeconds": 90}. Une personne ou un agent pilote le navigateur manuellement pendant que tout est enregistré. À utiliser pour l'exploration.

3. Enregistrer (web : Chrome DevTools Protocol, zéro dépendance)

chrome --remote-debugging-port=9222 --user-data-dir=/tmp/vua   # profil jetable
node scripts/record.mjs scenario.json --port 9222 --out ./audit-out
bash scripts/encode.sh ./audit-out                 # → audit.mp4
node scripts/timeline.mjs ./audit-out              # → timeline.md, signals.json, ai-pack/
node scripts/report.mjs ./audit-out --title "X"    # → findings.md (constats légendés)

Étapes du scénario : goto, say, click (sélecteur CSS, avec un pointeur visible), type (vitesse humaine), press, scroll, wait et problem (une légende rouge, une capture d'écran et un constat).

Les autres environnements utilisent la même méthode avec une capture différente. Quelle que soit la plateforme, enregistrez l'écran ainsi que les flux de logs et réseau de la plateforme, mettez-les tous sur une seule horloge et passez-les à timeline.mjs sous forme de events.json :

PlateformeÉcranLogs et réseau
iOSxcrun simctl io booted recordVideolog stream ; un proxy (mitmproxy) pour le réseau
Androidadb shell screenrecordadb logcat ; un proxy pour le réseau
Bureau / ElectronCapture d'écran du systèmele port CDP, comme pour le web
Terminal / CLIasciinemastderr, avec horodatages

4. Signaux automatiques (trouvés pour vous, vérifiez chacun par rapport à son image)

SignalSignification typique
js-exception, console-errorFonctionnalité cassée, souvent silencieuse pour l'utilisateur
request-failed, http-5xx, http-4xxDonnées manquantes, mauvais état, mauvaises permissions
slow-request (≥ 1 s ; P1 à ≥ 3 s)Une attente que l'utilisateur ressent ; candidat au cache, préchargement ou index
heavy-payload (≥ 500 Ko)Lent sur mobile ; paginer, compresser ou réduire les champs
duplicate-request (même appel dans les 2 s)Travail gaspillé ; dédoublonner ou mettre en cache
never-finishedRequête pendante, délai d'attente manquant, spinner infini
long-task (≥ 200 ms ; P1 à ≥ 500 ms)Interface gelée ; diviser le travail, virtualiser, déplacer vers un worker
layout-shift (≥ 0.05, sans saisie)Contenu qui saute ; réserver de l'espace

Les seuils peuvent être modifiés avec --slow et --big.

5. Examen IA en un seul passage

Donnez à l'IA ai-pack/ (les images clés, timeline.md et PROMPT.md). Elle renvoie, en un seul passage :

  1. Problèmes, chacun avec sévérité et preuve : une image et les lignes de timeline qui l'expliquent.
  2. Lacunes : chemins morts, retours manquants, états flous, affordances manquantes et deux écrans en désaccord.
  3. Opportunités : requêtes à supprimer, mettre en cache ou précharger ; étapes à fusionner ; valeurs par défaut à définir ; ce qu'un concurrent de premier plan fait mieux.
  4. Un classement de tout par impact utilisateur ÷ effort.

Règle : pas de preuve, pas de ligne. Chaque affirmation cite une image ou un événement.

6. Sévérité

  • P0 : perte de données, mauvais destinataire, fuite de vie privée ou de sécurité, ou la tâche principale est impossible.
  • P1 : la tâche principale est cassée ou trompeuse, une action prend plus d'1 s ou une vue plus de 3 s, une exception JS se trouve sur le chemin principal, ou deux surfaces sont en désaccord.
  • P2 : friction, formulation confuse, problème esthétique ou requêtes gaspillées.

7. Boucler la boucle

  • Corrigez d'abord les P0, puis les P1, avec un petit changement par constat.
  • Réexécutez le même scénario après chaque correctif. Sa nouvelle timeline est la preuve : le signal a disparu et le timing s'est amélioré. Joignez l'avant et l'après.
  • Conservez les scénarios comme une bibliothèque. Les réexécuter après chaque version permet de détecter les régressions en quelques secondes.

Skills associés