CommunityProgramación y desarrollogithub.com

auditoría-ux-de-video-y-línea-de-tiempo

Instrumento universal para encontrar problemas, brechas y oportunidades en cualquier IU rápidamente. Graba una sesión corta de una persona usándola, captura cada evento de consola, red y rendimiento en el mismo reloj que los fotogramas de video, y deja que una IA revise toda la línea de tiempo fusionada de una sola vez. La salida es un findings.md clasificado con evidencia y soluciones de UX y rendimiento.

¿Qué es auditoría-ux-de-video-y-línea-de-tiempo?

Esta habilidad, 'Video + timeline UX audit', es un instrumento universal diseñado para descubrir problemas, brechas y oportunidades en cualquier interfaz de usuario de forma rápida y sistemática. Funciona grabando una sesión corta de una persona real usando la IU (de 10 segundos a 5 minutos) y sincronizando en un solo reloj todos los eventos: video de la pantalla, mensajes de consola, excepciones, solicitudes de red (estado, duración, bytes, fallos), tareas largas y cambios de diseño. Luego, una IA multimodal revisa la línea de tiempo fusionada y los fotogramas clave en una sola pasada, generando un informe clasificado (`findings.md`) con problemas (P0, P1, P2), brechas y oportunidades, cada uno con evidencia adjunta (fotograma y eventos). La habilidad es compatible con plataformas web (usando Chrome DevTools Protocol), iOS, Android, escritorio/Electron y terminal/CLI, usando diferentes capturadores pero la misma línea de tiempo central. Es útil para auditorías rápidas de vistas, flujos o aplicaciones, para diagnosticar por qué algo se siente roto o lento, antes de un rediseño o después de un lanzamiento. El flujo de trabajo incluye pasos de seguridad (cuentas de prueba, perfil desechable), marcos de sesión (definir trabajos del usuario, elegir duración) y un proceso de grabación, análisis y revisión por IA, con la opción de sesiones guionadas o libres.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Auditoría de UX de video + línea de tiempo

La idea: unos segundos a unos minutos de uso real ya contienen la mayor parte de lo que está mal. Los problemas pasan desapercibidos porque nadie ve todo a la vez: lo que la persona intentó, lo que mostró la pantalla, lo que registró el código y lo que hizo la red. Este método graba todo en un solo reloj, para que cada fotograma pueda ser explicado por sus eventos y cada evento pueda verse en su fotograma. Luego, una IA lee la imagen completa en una sola pasada.

Salidas

ArchivoQué es
audit.mp4La sesión, con subtítulos incrustados: negro para la intención, rojo para cada problema
events.jsonCada acción, subtítulo, mensaje de consola, excepción, solicitud (estado, ms, bytes, fallos), tarea larga y cambio de diseño, con marca de tiempo en el reloj del video
timeline.mdLa línea de tiempo fusionada, más señales detectadas automáticamente, cada una vinculada al fotograma donde ocurrió
ai-pack/Fotogramas clave nombrados por el tiempo del video, timeline.md y PROMPT.md, listos para que cualquier LLM multimodal los revise en una sola pasada
findings.mdLa lista final clasificada: problemas, brechas y oportunidades, cada uno con evidencia, una solución de UX y una solución de rendimiento

0. Seguridad

  • Usa cuentas de prueba y datos de prueba, y escribe solo en un entorno aislado. Los datos reales de usuarios son de solo lectura.
  • Nunca publiques nombres, correos electrónicos, números de teléfono, identificadores o tokens. Limpia events.json (URLs, texto de consola) antes de compartir.
  • Usa un perfil de navegador desechable y ciérralo al final.

1. Enmarca la sesión (2 minutos)

  • Nombra de uno a tres trabajos para los que viene un usuario real, en sus propias palabras. Por ejemplo: "encontrar el pedido", "responder al cliente", "cambiar mi plan".
  • Elige la duración adecuada para la IU: 10–60 s para una pantalla, 2–5 min para un flujo completo. Las sesiones cortas y enfocadas superan a las largas.

2. Actúa como una persona real y no técnica

  • Di lo que pretendes hacer antes de cada movimiento (un subtítulo say).
  • Usa solo lo que está visible. Sin URLs escritas, sin herramientas de desarrollador, sin atajos ocultos.
  • Prueba primero el camino obvio. Cuando falla, eso es un hallazgo, incluso si otra ruta funciona.
  • Después de cada acción, verifica que todo concuerde: lista, contadores, encabezado, otros paneles y la vista de la otra parte.
  • Somete a prueba el estado. Recarga, retrocede, abre en una nueva pestaña, usa una red lenta y usa el ancho de un teléfono (390×844).
  • Anota las esperas. Si esperas, el usuario espera.

Hay dos formas de dirigir:

  • Guionizada. Un scenario.json con pasos. Es repetible, y el mismo archivo se convierte en la prueba de regresión después de la corrección.
  • Libre. {"url": "...", "freeSeconds": 90}. Una persona o un agente conduce el navegador manualmente mientras todo se graba. Úsalo para exploración.

3. Grabar (web: Protocolo Chrome DevTools, sin dependencias)

chrome --remote-debugging-port=9222 --user-data-dir=/tmp/vua   # perfil desechable
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 (hallazgos subtitulados)

Pasos del guion: goto (ir a), say (decir), click (selector CSS, con un puntero visible), type (escribir, a velocidad humana), press (presionar), scroll (desplazar), wait (esperar) y problem (problema, un subtítulo rojo, una captura de pantalla y un hallazgo).

Otros entornos usan el mismo método con una captura diferente. Sea cual sea la plataforma, graba la pantalla más los registros de la plataforma y las transmisiones de red, ponlos todos en un mismo reloj y pásalos a timeline.mjs como events.json:

PlataformaPantallaRegistros y red
iOSxcrun simctl io booted recordVideolog stream; un proxy (mitmproxy) para la red
Androidadb shell screenrecordadb logcat; un proxy para la red
Escritorio / ElectronCaptura de pantalla del SOel puerto CDP, como para la web
Terminal / CLIasciinemastderr, con marcas de tiempo

4. Señales automáticas (encontradas por ti, verifica cada una contra su fotograma)

SeñalSignificado típico
js-exception (excepción JS), console-error (error de consola)Funcionalidad rota, a menudo silenciosa para el usuario
request-failed (solicitud fallida), http-5xx, http-4xxDatos faltantes, estado incorrecto, permisos incorrectos
slow-request (solicitud lenta) (≥ 1 s; P1 a ≥ 3 s)Una espera que el usuario siente; candidato a caché, precarga o índice
heavy-payload (carga pesada) (≥ 500 KB)Lento en móvil; paginar, comprimir o recortar campos
duplicate-request (solicitud duplicada) (misma llamada en 2 s)Trabajo desperdiciado; deduplicar o almacenar en caché
never-finished (nunca terminó)Solicitud colgada, falta de tiempo de espera, spinner infinito
long-task (tarea larga) (≥ 200 ms; P1 a ≥ 500 ms)IU congelada; dividir el trabajo, virtualizar, mover a un worker
layout-shift (cambio de diseño) (≥ 0.05, sin entrada)El contenido salta; reservar espacio

Los umbrales se pueden cambiar con --slow y --big.

5. Revisión por IA en una sola pasada

Entrega a la IA ai-pack/ (los fotogramas clave, timeline.md y PROMPT.md). Devuelve, en una sola pasada:

  1. Problemas, cada uno con gravedad y evidencia: un fotograma y las líneas de la línea de tiempo que lo explican.
  2. Brechas: callejones sin salida, falta de retroalimentación, estados poco claros, falta de affordances y dos pantallas que no concuerdan.
  3. Oportunidades: solicitudes que eliminar, almacenar en caché o precargar; pasos que fusionar; valores predeterminados que establecer; qué hace mejor un competidor principal.
  4. Una clasificación de todo por impacto ÷ esfuerzo del usuario.

Regla: sin evidencia, no hay fila. Cada afirmación cita un fotograma o un evento.

6. Gravedad

  • P0: pérdida de datos, destinatario incorrecto, fuga de privacidad o seguridad, o el trabajo principal es imposible.
  • P1: el trabajo principal está roto o es engañoso, una acción tarda más de 1 s o una vista más de 3 s, una excepción JS se encuentra en la ruta principal, o dos superficies no concuerdan.
  • P2: fricción, redacción confusa, un problema cosmético o solicitudes desperdiciadas.

7. Cerrar el ciclo

  • Corrige primero los P0, luego los P1, con un pequeño cambio por hallazgo.
  • Vuelve a ejecutar el mismo escenario después de cada corrección. Su nueva línea de tiempo es la prueba: la señal ha desaparecido y el tiempo es mejor. Adjunta el antes y el después.
  • Conserva los escenarios como una biblioteca. Volver a ejecutarlos después de cada lanzamiento detecta regresiones en segundos.

Skills relacionados