Communitygithub.com

check-user-experience

Audita uma interface contra as 30 Leis de UX (lawsofux.com) e produz um relatório priorizado de problemas reais com correções concretas.

O que é check-user-experience?

Este skill realiza uma auditoria completa de interface do usuário com base nas 30 Leis de UX (como Fitts, Hick, Jakob, Miller, Doherty, Postel, Tesler, Von Restorff, Gestalt, entre outras). Ele analisa repositórios de código (detectando frameworks como React, Vue, Svelte, Angular, Flutter, SwiftUI, etc.), URLs ao vivo ou capturas de tela, identifica as tarefas primárias do usuário e verifica cada lei para encontrar violações acionáveis. O resultado é um relatório priorizado por severidade (Alta, Média, Baixa) com a localização exata de cada problema e uma sugestão de correção específica. O skill é particularmente útil para desenvolvedores e designers que desejam validar rapidamente a usabilidade de um aplicativo ou página, sem substituir uma auditoria completa de acessibilidade (WCAG). Ele não aplica correções automaticamente a menos que o usuário solicite.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aswin-haridas/skills/tree/HEAD/skills/check-user-experience

Perguntar na sua IA favorita

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

Documentação

Verificar Experiência do Usuário

Audite uma interface de acordo com as Leis de UX e produza um relatório priorizado de problemas reais com correções concretas. Relate, não corrija, a menos que o usuário peça.

Fluxo de Trabalho

1. Reúna a Superfície

  • Repositório de código: detecte a pilha tecnológica e encontre telas/rotas, componentes compartilhados (botões, inputs, formulários, navegação, modais, listas, tabelas), tokens de design e estados de carregamento/erro. Leia o código real (marcação e estilos), não apenas nomes de arquivos.
  • URL ao vivo / build local: abra no navegador, percorra os fluxos principais, tire capturas de tela nas larguras desktop e mobile, meça alvos de toque e tempos de resposta quando possível.
  • Captura de tela: julgue visualmente; marque verificações baseadas em código como 'não verificáveis'.
  • Identifique as 3–5 tarefas principais do usuário (cadastro, busca, checkout, criar X). Audite esses fluxos com mais rigor — o Princípio de Pareto também se aplica à auditoria.

2. Verifique Cada Lei

Percorra a tabela abaixo. Para cada lei, procure pelos sinais listados. Relate apenas descobertas concretas com localização; nunca preencha o relatório com conselhos genéricos. Se uma lei for atendida, coloque-a na lista de 'aprovados' em uma linha.

3. Relatório (formato abaixo) e então ofereça para corrigir os itens Altos.

As Leis: O Que Procurar e Como Corrigir

Interação e Esforço

LeiSinal de AlertaCorreção Sugerida
Lei de Fitts — o tempo para atingir um alvo depende do tamanho e da distânciaAlvos de toque < 44×44 pt (iOS) / 48×48 dp (Android) / 24×24 CSS px mín (WCAG 2.5.8), ideal 44px; botões com apenas ícone e padding pequeno; ação primária longe do olho/polegar; botões destrutivo e primário adjacentes com < 8px de separaçãoAumente o padding ou adicione ::after { inset:-8px } como área de toque; coloque o CTA primário perto do conteúdo que ele afeta, na zona do polegar em mobile; separe ações destrutivas
Lei de Hick — o tempo de decisão cresce com o número/complexidade das escolhasNavegação com > 7 itens de primeiro nível; menus/selects com listas longas não ordenadas; vários CTAs com pesos iguais na mesma telaAgrupe, revele progressivamente ('Mais'), adicione busca/filtro a listas longas, defaults sensatos, um CTA primário
Sobrecarga de EscolhaPáginas de preço/plano com > 3–4 opções e nenhuma recomendação; painéis de configurações confusos; muitos filtros exibidos de uma vezDestaque uma opção recomendada, recolha opções avançadas, tabela comparativa
Limiar de Doherty — a produtividade dispara quando a resposta < 400 msSem estado de carregamento/pendente em ações assíncronas; botões não desabilitam ou mostram progresso ao enviar; spinners de tela cheia para cargas pequenas; sem atualizações otimistas; chamadas de rede bloqueantes em inputsFeedback imediato < 100 ms, skeletons, UI otimista, spinners atrasados (~300 ms), debounce na busca
Lei de Postel — seja liberal no que aceitaFormatos de entrada rígidos (telefone, datas, números de cartão rejeitando espaços/traços); e-mails com diferenciação de maiúsculas/minúsculas; sem trim; erros de validação que não explicam como corrigir; colagem bloqueadaNormalize a entrada (trim, remova separadores), aceite múltiplos formatos, atributos inputmode/autocomplete, mensagens de erro úteis
Lei de Tesler — a complexidade não pode ser removida, apenas movidaUsuário forçado a fazer o que o sistema poderia (reinserir dados conhecidos, calcular valores, escolher fuso horário/país inferível)Autopreenchimento, defaults inteligentes, inferência, lembrar últimas escolhas
Paradoxo do Usuário Ativo — usuários não leem manuaisFuncionalidades descobertas apenas via documentação/dicas ao passar o mouse; longos tutoriais de onboarding antes de mostrar valor; estados vazios sem orientaçãoDicas inline no ponto de uso, estados vazios acionáveis, onboarding baseado em prática
Flow (Estado de Fluxo)Interrupções desnecessárias (modais, confirmações para ações reversíveis, reautenticação forçada); sem atalhos de teclado para caminhos de poder; perda de foco após açõesDesfazer em vez de confirmar, preservar foco/scroll, suporte a teclado, minimizar mudanças de contexto

Memória e Cognição

LeiSinal de AlertaCorreção Sugerida
Lei de Miller / AgrupamentoFormulários longos sem quebras; strings longas exibidas cruas (IDs, telefone, números de cartão não formatados); paredes de texto; navegação com 10+ itens planosDivida formulários em grupos/etapas, formate números em blocos, cabeçalhos e parágrafos curtos
Carga CognitivaTelas densas com elementos concorrentes; jargão; terminologia inconsistente para a mesma coisa; poluição decorativaRemova elementos não essenciais, rótulos consistentes, linguagem simples
Memória de TrabalhoUsuário precisa lembrar informações de uma tela anterior (códigos, escolhas anteriores); placeholders que desaparecem ao digitar; comparações entre páginasMantenha o contexto visível (resumos, rótulos persistentes, breadcrumbs), comparação lado a lado
Modelo MentalControles que se comportam diferente de sua aparência (link com estilo de botão fazendo navegação ou vice-versa); metáforas incomuns; modelo de salvamento pouco claro (autosalvar vs manual)Corresponda à expectativa do usuário; torne o estado do sistema explícito
Lei de Jakob — usuários esperam que seu site funcione como os outrosPosicionamento não padrão (logotipo não linka para home, carrinho não no canto superior direito, busca escondida); controles customizados substituindo nativos sem paridade; padrões reinventadosSiga convenções da plataforma (HIG / Material / normas web); use elementos nativos primeiro
Navalha de OccamEtapas redundantes, controles duplicados, funcionalidades que nenhum fluxo precisa na tela principalRemova ou mova para superfícies secundárias
Princípio de ParetoTarefas primárias enterradas enquanto funcionalidades raramente usadas ocupam espaço nobrePromova os 20% das funcionalidades usadas 80% do tempo
Lei de ParkinsonFormulários/tarefas que demoram mais que o necessário; sem autopreenchimento; sem indicadores de progresso que definam expectativasAutocomplete, atributos autofill, mostre tempo/etapas estimados
Atenção Seletiva / Cegueira de BannerInformações críticas estilizadas como anúncios ou colocadas em banners/barras laterais; avisos importantes se misturandoColoque informações-chave inline no caminho da tarefa, distintos mas não parecendo anúncios
Viés CognitivoPadrões escuros: opt-ins pré-marcados, confirmshaming, custos ocultos, falsa urgência, defaults enganososRemova; defaults honestos. Marque como Alta (risco ético + legal)

Percepção (Gestalt)

LeiSinal de AlertaCorreção Sugerida
Lei da ProximidadeRótulos mais próximos do input errado; espaçamento igual entre itens não relacionados e relacionados; texto de ajuda longe de seu campoEspaçamento mais apertado dentro de grupos, maior entre grupos (escala de espaçamento)
Lei da SemelhançaElementos com mesma aparência comportando-se de forma diferente (texto clicável e estático idênticos); estilos de botão inconsistentes para o mesmo nível de açãoLinguagem visual consistente por função
Lei da Região ComumControles relacionados não agrupados; cards sem bordas misturando conteúdoCards, seções, regiões de fundo para grupos
Lei da Conexão UniformeEtapas/itens relacionados não vinculados visualmenteLinhas, conectores, contêineres compartilhados para steppers/timelines
Lei de PrägnanzÍcones/ilustrações excessivamente complexos, formas ambíguasSimplifique formas; ícones reconhecíveis com rótulos
Efeito Estética-UsabilidadeInconsistência visual (raios misturados, cores aleatórias, grade desalinhada, escala tipográfica inconsistente) que mina a confiançaTokenize espaçamento/tipo/cor; alinhe a uma grade

Sequência, Motivação e Memória da Experiência

LeiSinal de AlertaCorreção Sugerida
Efeito Von RestorffCTA primário não visualmente distinto; tudo destacado para que nada se sobressaia; dependência apenas de corUma ação primária enfatizada por visualização; use também forma/tamanho/ícone (acessibilidade)
Efeito de Posição SerialItens-chave de navegação no meio de listas longas; informações mais importantes enterradas no meio da páginaColoque itens-chave primeiro e último (ex.: Home primeiro, Perfil/Carrinho por último na barra de abas)
Regra do Pico-FimEstados de sucesso fracos ou ausentes (envio de formulário termina com nada ou um redirect simples); becos sem saída de erro; finais de fluxo abruptosConfirmação clara e satisfatória; recuperação útil em erros; polir a etapa final
Efeito Gradiente de ObjetivoFluxos de várias etapas sem indicação de progresso; progresso que começa em 0Stepper/barra de progresso, mostre etapas restantes, dê uma vantagem inicial
Efeito ZeigarnikTarefas incompletas esquecidas (sem rascunhos, dados de formulário perdidos ao navegar, sem lembretes de conclusão de perfil)Autosalvar rascunhos, 'continue de onde parou', listas de verificação de conclusão

Severidade

  • Alta — bloqueia ou atrasa seriamente uma tarefa primária, causa erros/perda de dados, falha de acessibilidade ou padrão escuro.
  • Média — atrito ou confusão notável em um caminho comum.
  • Baixa — polimento; telas secundárias.

Formato do Relatório

# UX Audit — <app/tela>
Escopo: <o que foi auditado> · Método: código / ao vivo / captura de tela
Pontuação: <leis aprovadas>/30 · Alta: n · Média: n · Baixa: n

## Top 3 para corrigir primeiro
1. ...

## Descobertas
### [Alta] Lei de Fitts — Botões de ícone muito pequenos
Onde: src/components/Toolbar.tsx:42 (também Header.tsx:18)
Problema: Botões de ícone de 20×20px sem padding; toques errados em mobile.
Correção: adicione `p-3` (alvo de 44px) ou uma extensão de área de toque `::after`.
```(trecho de código se curto)```

(...um bloco por descoberta, agrupado por severidade, Alta primeiro…)

## Aprovados
- Lei de Jakob — navegação padrão e padrão logotipo-home.
- ...

## Não verificáveis
- Limiar de Doherty — precisa de um aplicativo em execução para medir tempos de resposta.

Regras

  • Toda descoberta precisa de uma lei, uma localização (arquivo:linha, URL + elemento ou região da captura de tela), o problema observado e uma correção específica. Sem localização → não relate.
  • Mescle duplicatas: uma descoberta por causa raiz, listando todas as localizações.
  • Não mude o estilo ou a personalidade do aplicativo nas correções; sugira a menor alteração que resolva o problema.
  • Respeite as convenções da plataforma (iOS HIG, Material, web) ao julgar a Lei de Jakob e os tamanhos de alvos.
  • Sobreposição com acessibilidade (contraste, foco, rótulos) é aceitável — anote sob a lei relevante, mas não transforme isso em uma auditoria WCAG completa.
  • Após o relatório, pergunte se deve corrigir as descobertas Altas (ou todas). Se problemas de movimento/feedback forem encontrados (Doherty, Pico-Fim, Gradiente de Objetivo), mencione que /animate-this-app pode resolvê-los.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas