CommunityCodierung & Entwicklunggithub.com

Video + Timeline UX Audit

Universelles Werkzeug, um schnell Probleme, Lücken und Chancen in jeder Benutzeroberfläche zu finden. Zeichnen Sie eine kurze Sitzung einer Person auf, die die UI nutzt, erfassen Sie alle Konsolen-, Netzwerk- und Leistungsereignisse auf derselben Zeitachse wie die Videobilder und lassen Sie eine KI die gesamte fusionierte Timeline in einem Durchgang überprüfen. Die Ausgabe ist eine nach Priorität geordnete `findings.md` mit Nachweisen sowie UX- und Leistungsbehebungen.

Was ist Video + Timeline UX Audit?

Dieses Skill führt eine videobasierte UX-Prüfung durch, indem es eine kurze Benutzersitzung aufzeichnet (z. B. 10 s–5 min) und alle Browser-Ereignisse – Konsolenmeldungen, Netzwerkanfragen, Long-Tasks, Layout-Shifts – auf denselben Takt wie die Videobilder legt. Das Ergebnis ist eine fusionierte Timeline, die sowohl für Menschen (mit eingebrannten Untertiteln im Video) als auch für KI (als Paket mit Keyframes und Markdown-Dateien) aufbereitet wird. Der Hauptvorteil liegt in der **One-Shot-Analyse durch eine multimodale KI**: Diese erhält alle Beweise (Bilder + Ereignisse) gleichzeitig und kann daher Probleme, Lücken und Optimierungen mit direkten Quellenangaben identifizieren. Das Skill unterstützt mehrere Plattformen (Web via Chrome DevTools Protocol, iOS/Android via Simulator/ADB, Desktop via Bildschirmaufnahme, Terminal via asciinema) und erzeugt automatisch Signale wie `js-exception`, `request-failed`, `slow-request` oder `layout-shift`. Die finale Ausgabe, `findings.md`, listet alle Erkenntnisse nach Schweregrad (P0–P2) geordnet auf, jeweils mit Beleg (Frame-Nummer, Timeline-Eintrag) und getrennten UX- und Performance-Behebungsvorschlägen.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Video + Timeline UX Audit?

Die Idee: Bereits wenige Sekunden bis Minuten echter Nutzung enthalten das meiste, was falsch läuft. Probleme entgehen der Analyse, weil niemand alles gleichzeitig sieht: was die Person versucht hat, was der Bildschirm anzeigte, was der Code protokollierte und was das Netzwerk tat. Diese Methode zeichnet alles auf einem Takt auf, sodass jedes Bild durch seine Ereignisse erklärt werden kann und jedes Ereignis in seinem Bild sichtbar ist. Eine KI liest dann das gesamte Bild in einem einzigen Durchgang.

Ausgaben

DateiBeschreibung
audit.mp4Die Sitzung mit eingebrannten Untertiteln: schwarz für Absicht, rot für jedes Problem
events.jsonJede Aktion, jeder Untertitel, jede Konsolenmeldung, Ausnahme, Anfrage (Status, ms, Bytes, Fehlschläge), Long-Task und Layout-Shift, mit Zeitstempel auf dem Video-Takt
timeline.mdDie fusionierte Timeline, plus automatisch erkannte Signale, jeweils verknüpft mit dem Frame, in dem sie auftraten
ai-pack/Schlüsselbilder benannt nach Videosekunden, timeline.md und PROMPT.md, bereit für jedes multimodale LLM zur Überprüfung in einem Durchgang
findings.mdDie endgültige priorisierte Liste: Probleme, Lücken und Chancen, jeweils mit Nachweisen, einer UX-Behebung und einer Performance-Behebung

0. Sicherheit

  • Verwenden Sie Testkonten und Testdaten, und führen Sie Schreibvorgänge nur in einer Sandbox durch. Echte Benutzerdaten sind schreibgeschützt.
  • Veröffentlichen Sie niemals Namen, E-Mails, Telefonnummern, IDs oder Tokens. Bereinigen Sie events.json (URLs, Konsolentext), bevor Sie es teilen.
  • Verwenden Sie ein wegwerfbares Browserprofil und schließen Sie es am Ende.

1. Rahmen der Sitzung (2 Minuten)

  • Nennen Sie ein bis drei Aufgaben, die ein echter Benutzer erledigen möchte, in seinen eigenen Worten. Zum Beispiel: „die Bestellung finden“, „dem Kunden antworten“, „meinen Plan ändern“.
  • Wählen Sie die Länge passend zur UI: 10–60 s für einen Bildschirm, 2–5 min für einen gesamten Ablauf. Kürzere, fokussierte Sitzungen sind besser als lange.

2. Verhalten Sie sich wie eine echte, nicht-technische Person

  • Sagen Sie Ihre Absicht vor jeder Bewegung (ein say-Untertitel).
  • Verwenden Sie nur, was sichtbar ist. Keine eingegebenen URLs, keine Entwicklertools, keine versteckten Tastenkürzel.
  • Versuchen Sie zuerst den offensichtlichen Weg. Wenn er scheitert, ist das ein Befund, selbst wenn ein anderer Weg funktioniert.
  • Überprüfen Sie nach jeder Aktion, ob alles übereinstimmt: Liste, Zähler, Kopfzeile, andere Panels und die Ansicht der anderen Partei.
  • Belasten Sie den Zustand. Neu laden, zurück gehen, in einem neuen Tab öffnen, ein langsames Netzwerk verwenden und Telefonbreite (390×844) nutzen.
  • Notieren Sie die Wartezeiten. Wenn Sie warten, wartet der Benutzer.

Es gibt zwei Arten der Steuerung:

  • Skriptgesteuert. Eine scenario.json mit Schritten. Sie ist wiederholbar, und dieselbe Datei wird nach der Behebung zum Regressionsnachweis.
  • Frei. {"url": "...", "freeSeconds": 90}. Eine Person oder ein Agent steuert den Browser manuell, während alles aufgezeichnet wird. Verwenden Sie dies für die Erkundung.

3. Aufzeichnung (Web: Chrome DevTools Protocol, keine Abhängigkeiten)

chrome --remote-debugging-port=9222 --user-data-dir=/tmp/vua   # wegwerfbares Profil
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 (mit Untertiteln versehene Befunde)

Skript-Schritte: goto, say, click (CSS-Selektor, mit sichtbarem Zeiger), type (menschliche Geschwindigkeit), press, scroll, wait und problem (ein roter Untertitel, ein Screenshot und ein Befund).

Andere Umgebungen verwenden dieselbe Methode mit einer anderen Erfassung. Unabhängig von der Plattform zeichnen Sie den Bildschirm plus die Protokoll- und Netzwerk-Streams der Plattform auf, legen alle auf einen Takt und übergeben sie an timeline.mjs als events.json:

PlattformBildschirmProtokolle und Netzwerk
iOSxcrun simctl io booted recordVideolog stream; ein Proxy (mitmproxy) für Netzwerk
Androidadb shell screenrecordadb logcat; ein Proxy für Netzwerk
Desktop / ElectronOS-Bildschirmaufnahmeden CDP-Port, wie für das Web
Terminal / CLIasciinemastderr, mit Zeitstempeln

4. Auto-Signale (für Sie gefunden; überprüfen Sie jedes anhand seines Bildes)

SignalTypische Bedeutung
js-exception, console-errorDefekte Funktion, oft still für den Benutzer
request-failed, http-5xx, http-4xxFehlende Daten, falscher Zustand, falsche Berechtigungen
slow-request (≥ 1 s; P1 bei ≥ 3 s)Eine Wartezeit, die der Benutzer spürt; Kandidat für Cache, Prefetch oder einen Index
heavy-payload (≥ 500 KB)Langsam auf mobilen Geräten; paginieren, komprimieren oder Felder kürzen
duplicate-request (gleicher Aufruf innerhalb von 2 s)Verschwendete Arbeit; deduplizieren oder cachen
never-finishedHängende Anfrage, fehlendes Timeout, endloser Spinner
long-task (≥ 200 ms; P1 bei ≥ 500 ms)Eingefrorene UI; Arbeit aufteilen, virtualisieren, in einen Worker verschieben
layout-shift (≥ 0,05, keine Eingabe)Inhalt springt; Platz reservieren

Die Schwellenwerte können mit --slow und --big geändert werden.

5. One-Shot-KI-Überprüfung

Geben Sie der KI ai-pack/ (die Schlüsselbilder, timeline.md und PROMPT.md). Sie liefert in einem einzigen Durchgang:

  1. Probleme, jeweils mit Schweregrad und Nachweis: ein Bild und die Timeline-Zeilen, die es erklären.
  2. Lücken: Sackgassen, fehlendes Feedback, unklare Zustände, fehlende Affordanzen und zwei Bildschirme, die nicht übereinstimmen.
  3. Chancen: Anfragen zum Entfernen, Cachen oder Prefetchen; Schritte zum Zusammenführen; Standardwerte zum Setzen; was ein Top-Konkurrent besser macht.
  4. Eine Priorisierung von allem nach Benutzereinfluss ÷ Aufwand.

Regel: Kein Beweis, keine Zeile. Jede Behauptung verweist auf ein Bild oder ein Ereignis.

6. Schweregrad

  • P0: Datenverlust, falscher Empfänger, Datenschutz- oder Sicherheitsleck, oder die Kernaufgabe ist unmöglich.
  • P1: Die Kernaufgabe ist defekt oder irreführend, eine Aktion dauert über 1 s oder eine Ansicht über 3 s, eine JS-Ausnahme liegt auf dem Hauptpfad, oder zwei Oberflächen widersprechen sich.
  • P2: Reibung, verwirrende Formulierung, kosmetisches Problem oder verschwendete Anfragen.

7. Den Kreislauf schließen

  • Beheben Sie zuerst P0, dann die P1s, mit einer kleinen Änderung pro Befund.
  • Führen Sie nach jeder Behebung dasselbe Szenario erneut aus. Seine neue Timeline ist der Beweis: Das Signal ist verschwunden und die Zeit ist besser. Fügen Sie das Vorher und Nachher an.
  • Bewahren Sie die Szenarien als Bibliothek auf. Erneutes Ausführen nach jedem Release erkennt Regressionen in Sekunden.

Verwandte Skills