auditoria-ux-video-timeline

Instrumento universal para encontrar rapidamente problemas, lacunas e oportunidades em qualquer interface. Grave uma sessão curta de uma pessoa usando-a, capture todos os eventos de console, rede e desempenho no mesmo relógio dos quadros de vídeo e deixe uma IA revisar toda a linha do tempo fusionada de uma só vez. A saída é um findings.md classificado com evidências e correções de UX e desempenho. Use para "auditar esta visualização/app/fluxo", "por que X parece quebrado ou lento", antes de um redesign ou após um lançamento.

O que é auditoria-ux-video-timeline?

Esta skill cria uma auditoria completa de UX e desempenho para qualquer interface de usuário (web, iOS, Android, desktop, terminal) gravando uma sessão de uso real e sincronizando todos os eventos (console, rede, layout shifts, long tasks) com o vídeo. A saída é um relatório detalhado (findings.md) com problemas classificados por severidade (P0 a P2), cada um com evidência visual e de evento, além de recomendações de correção de UX e desempenho. Suporta roteiros repetíveis (scenario.json) ou sessões exploratórias livres. A skill usa o Chrome DevTools Protocol para captura na web e ferramentas similares (adb logcat, xcrun simctl, asciinema) para outras plataformas. O ponto forte é a capacidade de alimentar a linha do tempo fusionada e keyframes em qualquer LLM multimodal para uma revisão única, gerando automaticamente sinais como exceções JS, requisições lentas, payloads pesados ou layout shifts. Ideal para identificar problemas que escapam em revisões normais porque cruza o que o usuário viu, o que o sistema registrou e o que a rede fez no mesmo instante.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Auditoria de UX com vídeo + linha do tempo

A ideia: alguns segundos a alguns minutos de uso real já contêm a maior parte do que está errado. Os problemas passam despercebidos porque ninguém vê tudo ao mesmo tempo: o que a pessoa tentou, o que a tela mostrou, o que o código registrou e o que a rede fez. Este método grava tudo no mesmo relógio, para que cada quadro possa ser explicado por seus eventos e cada evento possa ser visto em seu quadro. Uma IA então lê a imagem completa em uma única passada.

Saídas

ArquivoO que é
audit.mp4A sessão, com legendas inseridas: preto para intenção, vermelho para cada problema
events.jsonCada ação, legenda, mensagem de console, exceção, requisição (status, ms, bytes, falhas), tarefa longa e mudança de layout, com timestamp no relógio do vídeo
timeline.mdA linha do tempo fusionada, mais sinais detectados automaticamente, cada um vinculado ao quadro onde ocorreu
ai-pack/Keyframes nomeados pelo tempo do vídeo, timeline.md e PROMPT.md, prontos para qualquer LLM multimodal revisar de uma só vez
findings.mdA lista final classificada: problemas, lacunas e oportunidades, cada um com evidência, uma correção de UX e uma correção de desempenho

0. Segurança

  • Use contas de teste e dados de teste, e faça escritas apenas em um sandbox. Dados reais de usuário são somente leitura.
  • Nunca publique nomes, e-mails, números de telefone, IDs ou tokens. Limpe events.json (URLs, texto do console) antes de compartilhar.
  • Use um perfil de navegador descartável e feche-o ao final.

1. Enquadre a sessão (2 minutos)

  • Nomeie de um a três trabalhos que um usuário real vem fazer, nas palavras dele. Por exemplo: "encontrar o pedido", "responder ao cliente", "mudar meu plano".
  • Escolha a duração para caber na interface: 10–60 s para uma tela, 2–5 min para um fluxo inteiro. Sessões mais curtas e focadas vencem as longas.

2. Aja como uma pessoa real, não técnica

  • Diga o que pretende antes de cada movimento (uma legenda say).
  • Use apenas o que está visível. Sem URLs digitadas, sem dev tools, sem atalhos ocultos.
  • Tente o caminho óbvio primeiro. Quando falhar, isso é um achado, mesmo que outra rota funcione.
  • Após cada ação, verifique se tudo concorda: lista, contadores, cabeçalho, outros painéis e a visão da outra parte.
  • Estresse o estado. Recarregue, volte, abra em uma nova aba, use uma rede lenta e use largura de telefone (390×844).
  • Anote as esperas. Se você espera, o usuário espera.

Existem duas maneiras de dirigir:

  • Roteirizado. Um scenario.json de passos. É repetível, e o mesmo arquivo se torna a prova de regressão após a correção.
  • Livre. {"url": "...", "freeSeconds": 90}. Uma pessoa ou um agente dirige o navegador manualmente enquanto tudo é gravado. Use para exploração.

3. Grave (web: Chrome DevTools Protocol, zero dependências)

chrome --remote-debugging-port=9222 --user-data-dir=/tmp/vua   # perfil descartável
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 (achados legendados)

Passos do cenário: goto, say, click (seletor CSS, com ponteiro visível), type (velocidade humana), press, scroll, wait, e problem (uma legenda vermelha, uma captura de tela e um achado).

Outros ambientes usam o mesmo método com uma captura diferente. Seja qual for a plataforma, grave a tela mais os fluxos de log e rede da plataforma, coloque todos no mesmo relógio e passe para timeline.mjs como events.json:

PlataformaTelaLogs e rede
iOSxcrun simctl io booted recordVideolog stream; um proxy (mitmproxy) para rede
Androidadb shell screenrecordadb logcat; um proxy para rede
Desktop / ElectronCaptura de tela do SOa porta CDP, como para a web
Terminal / CLIasciinemastderr, com timestamps

4. Sinais automáticos (encontrados para você, verifique cada um contra seu quadro)

SinalSignificado típico
js-exception, console-errorFuncionalidade quebrada, geralmente silenciosa para o usuário
request-failed, http-5xx, http-4xxDados ausentes, estado errado, permissões ruins
slow-request (≥ 1 s; P1 em ≥ 3 s)Uma espera que o usuário sente; candidato para cache, pré-busca ou um índice
heavy-payload (≥ 500 KB)Lento no celular; paginar, comprimir ou podar campos
duplicate-request (mesma chamada dentro de 2 s)Trabalho desperdiçado; deduplicar ou cachear
never-finishedRequisição pendurada, timeout ausente, spinner para sempre
long-task (≥ 200 ms; P1 em ≥ 500 ms)Interface congelada; dividir o trabalho, virtualizar, mover para um worker
layout-shift (≥ 0.05, sem entrada)Conteúdo pula; reservar espaço

Os limites podem ser alterados com --slow e --big.

5. Revisão única por IA

Dê à IA ai-pack/ (os keyframes, timeline.md e PROMPT.md). Ela retorna, em uma única passada:

  1. Problemas, cada um com gravidade e evidência: um quadro e as linhas da linha do tempo que o explicam.
  2. Lacunas: becos sem saída, feedback ausente, estados pouco claros, affordances faltando e duas telas que discordam.
  3. Oportunidades: requisições para remover, cachear ou pré-buscar; passos para mesclar; padrões para definir; o que um concorrente principal faz melhor.
  4. Uma classificação de tudo por impacto ÷ esforço.

Regra: sem evidência, sem linha. Cada afirmação cita um quadro ou um evento.

6. Gravidade

  • P0: perda de dados, destinatário errado, vazamento de privacidade ou segurança, ou a tarefa principal é impossível.
  • P1: a tarefa principal está quebrada ou enganosa, uma ação leva mais de 1 s ou uma visualização mais de 3 s, uma exceção JS está no caminho principal, ou duas superfícies discordam.
  • P2: atrito, texto confuso, um problema cosmético ou requisições desperdiçadas.

7. Feche o ciclo

  • Corrija P0 primeiro, depois os P1s, com uma pequena mudança por achado.
  • Reexecute o mesmo cenário após cada correção. Sua nova linha do tempo é a prova: o sinal se foi e o tempo está melhor. Anexe o antes e o depois.
  • Mantenha os cenários como uma biblioteca. Reexecutá-los após cada lançamento pega regressões em segundos.

Habilidades Relacionadas