Communitygithub.com

ui-ux-design

Projeta, implementa, revisa e critica interfaces (web apps, SaaS B2B, dashboards, formulários, tabelas, mobile) com base em usabilidade e design visual verificáveis — Heurísticas de Nielsen, Leis de UX (Yablonski), Refactoring UI, design centrado no usuário (Lowdermilk, ISO 9241), WCAG 2.2 AA e padrões com evidência (NN/g, GOV.UK, Baymard).

O que é ui-ux-design?

Esta skill capacita o agente a projetar, revisar e criticar interfaces de usuário (UI) com rigor profissional, combinando princípios clássicos (Heurísticas de Nielsen, Leis de UX) com técnicas modernas (Refactoring UI) e padrões de acessibilidade (WCAG 2.2 AA). O objetivo é garantir que cada decisão de design seja justificada por evidências ou regras claras, priorizando o contexto de uso do projeto (CLAUDE.md, sistema de design) e a necessidade real do usuário (ISO 9241-11). A skill cobre desde a estruturação de formulários, tabelas, dashboards e navegação até o design visual (escalas de espaçamento, tipografia, cor, profundidade) e acessibilidade (contraste, foco de teclado, leitores de tela). Ela é acionada sempre que o código toca em componentes, estilos (Tailwind/CSS) ou telas, bem como em revisões de UI, decisões entre alternativas de design, criação de microcopy ou preparação de testes de usabilidade. A skill estabelece uma hierarquia de autoridade: primeiro o sistema de design do projeto, depois regras duras de acessibilidade, em seguida evidências de pesquisa (NN/g, Baymard, GOV.UK), e por último os conselhos táticos de ofício (Refactoring UI). Todas as recomendações são explicitamente associadas ao seu nível: obrigatório (WCAG), recomendado (evidência) ou preferência (ofício).

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JVISERASS/ui-ux-design/tree/main

Perguntar na sua IA favorita

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

Documentação

UI/UX Design

Skill pessoal. Destila com palavras próprias três livros (Lowdermilk, User-Centered Design; Yablonski, Laws of UX; Wathan e Schoger, Refactoring UI) mais NN/g, WCAG 2.2 e sistemas de design públicos. O detalhe, com fontes e o não verificado marcado, está em references/. Este ficheiro é o que se deve ter na cabeça sempre.

0. Quem manda

Quando dois conselhos colidem, ganha o de cima:

  1. O sistema de design e as instruções do projeto (CLAUDE.md, tokens, primitivas, guia de marca). Se o projeto diz "raio 0 e sem sombras", não se propõem sombras embora o Refactoring UI as recomende: consegue-se a profundidade com o que o sistema permite (filete, fundo, espaço). Ler os tokens e componentes existentes antes de inventar nenhum.
  2. Regras duras: acessibilidade WCAG 2.2 AA e não enganar o usuário. Se o sistema do projeto viola contraste ou foco, sinaliza-se com o critério WCAG e uma alternativa dentro do sistema.
  3. Evidência: estudos e guias com dados (NN/g, Baymard, GOV.UK, normas ISO).
  4. Ofício: os conselhos táticos do Refactoring UI e similares. São bons por defeito, não leis.

Dizer sempre a que nível pertence uma recomendação: "WCAG 1.4.3 (obrigatório)" não pesa o mesmo que "costuma ficar melhor assim".

1. Antes de pintar nada: a necessidade

As solicitações chegam como soluções ("adiciona exportar para CSV", "põe um botão aqui"). Por baixo há uma necessidade, e projetar a solução literal costuma dar mais superfície e pior resultado. Por isso, antes de projetar:

  • Reformular a solicitação como: quando [situação], [pessoa] quer [resultado] para [motivo]. Se não se consegue preencher a situação nem o motivo, perguntar ou declarar a suposição.
  • Contexto de uso (ISO 9241-11): quem, que tarefa, onde e com quê (móvel ao sol, desktop com dois ecrãs, uso diário experiente ou uma vez por ano). "Usável" não existe em abstrato: sempre para alguém, para uma tarefa, num contexto.
  • Procurar o jeito atual (Excel, WhatsApp, papel): é a melhor especificação do que é preciso.
  • Oferecer pelo menos uma alternativa que resolva a mesma necessidade com menos interface, se existir.
  • Caminho feliz primeiro, e logo os estados: carregamento, vazio (primeira vez / por filtro / sem permissões), erro, sucesso, parcial. Uma tela sem seus estados não está projetada.

Para entrevistas, testes de usabilidade, número de usuários, métricas e SUS → references/centrado-em-usuario.md.

2. Estrutura e interação (o que mais pesa na usabilidade)

Heurísticas de Nielsen, como lista de verificação de um relance:

  1. Estado visível: o sistema diz o que está a acontecer (guardando, guardado, carregando, erro).
  2. Linguagem do usuário, não do modelo de dados.
  3. Controlo e liberdade: desfazer, cancelar, voltar.
  4. Consistência: o mesmo vê-se e comporta-se igual, e as convenções são respeitadas.
  5. Prevenção de erros: restrições, bons valores por defeito, aceitar formatos variados.
  6. Reconhecer melhor do que recordar.
  7. Atalhos para especialistas sem atrapalhar os novatos.
  8. Minimalismo: cada elemento compete com os outros.
  9. Erros que dizem o que aconteceu e como corrigir.
  10. Ajuda em contexto.

Leis de UX que mais se usam, com o seu limite:

LeiAplicarCuidado com
JakobPadrões convencionais; inovar no valor, não na navegaçãoAs convenções do setor (ERP, CAD) pesam mais do que as da web geral
FittsObjetos grandes e perto de onde está a atenção; botão de envio junto ao último campoAs esquinas "infinitas" só valem com rato, não em tátil
HickMenos opções onde há pressa; destacar a recomendada; revelar progressivamenteSó vale para escolher entre opções conhecidas; para procurar, manda a organização (ordem, grupos, busca)
Miller / memória de trabalhoAgrupar (chunking); que o sistema se lembre pelo usuárioO "7±2" não limita menus: o visível não carrega a memória. A capacidade real ronda ~4 blocos (Cowan)
TeslerQue a complexidade seja absorvida pelo sistema (valores por defeito, autocompletar, cálculo)Esconder não é simplificar: apenas desloca a complexidade
PostelAceitar formatos variados e normalizarAceitar não é adivinhar em silêncio: se é ambíguo, mostrar a interpretação ou perguntar
Peak-EndCuidar o momento de mais valor e o fecho; vigiar os picos negativos—
Von RestorffUm único elemento destacado por zonaSe tudo destaca, nada destaca, e o destacado pode parecer um anúncio
Tempos de resposta<0,1 s nada; ~1 s feedback ligeiro; 2–10 s esqueleto ou spinner; >10 s % + cancelarO "400 ms" de Doherty não aparece no relatório original de 1982; usar 0,1/1/10 s de Nielsen
Goal-gradientProgresso visível e honesto em processos longosO progresso falso é um padrão enganoso

As 30 leis, o mapa por situação (formulários, onboarding, checkout, tabelas, móvel…) e os maus usos → references/leyes-ux.md.

Padrões com evidência (detalhe e fontes → references/patrones.md):

  • Formulários: etiqueta em cima e visível (nunca o placeholder como etiqueta); uma coluna; autocomplete e inputmode corretos; não partir telefone, data nem IBAN em vários campos; validar ao sair do campo ou ao enviar e remover o erro assim que corrigido ("premiar cedo, castigar tarde"); o erro junto ao campo, que diga o que aconteceu e como corrigir, com as palavras da etiqueta; conservar sempre o escrito.
  • Botões: verbo + objeto ("Guardar fatura", não "Aceitar"); um único botão principal por vista; evitar os desativados que não explicam o porquê (melhor deixar clicar e explicar); evitar o duplo envio.
  • Destrutivo: melhor desfazer do que confirmar; confirmar apenas o irreversível, dizendo o que se perde e com botões com a ação ("Eliminar 3 faturas" / "Conservar"), não Sim/Não.
  • Vazios: dizer que está vazio (e não a carregar), o que aparecerá aqui e o botão para começar; esconder filtros e ordenação enquanto não houver nada.
  • Tabelas: identificador legível na primeira coluna; números à direita com tabular-nums e os mesmos decimais; cabeçalho fixo; filtros visíveis com o ativo à vista; ações de linha visíveis, não apenas ao passar o rato; alternativa ao arrasto. Em móvel: cartões para rever registos e tabela com a primeira coluna fixa para comparar.
  • Dashboards: uma tarefa; cada cifra com comparação, unidade e período; barras e linhas antes de tartes ou velocímetros; a cor com significado, nunca como única pista.
  • Navegação: visível em desktop (o hambúrguer reduz a descoberta); em móvel, barra inferior de 3–5 destinos com ícone e texto; o frequente em zonas alcançáveis e nada crítico nas esquinas superiores.
  • Microcopy: o importante nas duas primeiras palavras; remover metade das palavras; subtítulos que se possam escanear; frases curtas em voz ativa; sem "Por favor", "Oops" nem "inválido".

3. Design visual (Refactoring UI, em curto)

Detalhe com valores e CSS/Tailwind → references/diseno-visual.md (a §11 é a chuveleta).

  • Começar pela funcionalidade, não pelo layout, e em escala de cinzas: se a hierarquia não funciona a cinzento, a cor não a arranja. A cor vai no final.
  • Sistemas antes que valores: escalas fixas de espaçamento, tamanho de fonte, cor, sombra e raio, e decidir escolhendo nelas. Em código: tokens; nada de valores arbitrários (p-[13px]) sem motivo.
  • Hierarquia com peso e cor antes que com tamanho: 2–3 tons de texto (primário, secundário, terciário) e 2 pesos (normal e semibold/bold); nada abaixo de 400. Destacar algo é muitas vezes atenuar o que compete.
  • As etiquetas são o último recurso: formatos que se explicam sozinhos ("12 em stock" melhor que "Stock: 12"); se for necessária etiqueta, que pese menos que o valor. Os títulos de secção costumam funcionar como etiquetas pequenas: a hierarquia visual não tem de seguir a dos h1…h6.
  • Espaçamento: começar com demasiado ar e cortar; escala não linear (4, 8, 12, 16, 24, 32, 48, 64, 96…) em que nenhum passo esteja a menos de ~25 % do seguinte; mais espaço entre grupos do que dentro de um grupo (a etiqueta colada ao seu campo).
  • Larguras: não esticar a toda a tela; max-width por componente; parágrafos de 45–75 caracteres; barra lateral de largura fixa e conteúdo flexível.
  • Texto: escala tipográfica feita à mão (12/14/16/18/20/24/30/36/48…) em px ou rem, nunca em em; entrelinha de ~1,5 no corpo e ~1–1,25 em títulos; títulos grandes com o tracking ligeiramente fechado e maiúsculas com o tracking aberto; alinhar por linha de base quando se misturam tamanhos; texto centrado apenas em 2–3 linhas.
  • Cor: 8–10 cinzas (ligeiramente matizados) e 5–10 tons por cor (100–900) definidos à partida, melhor em OKLCH (luminosidade percebida uniforme); mais croma nos extremos; nunca texto cinza sobre fundo de cor (usar um tom da mesma cor); badges com contraste invertido (fundo claro matizado e texto escuro do mesmo tom); a cor nunca como único sinal.
  • Botões por importância, não por semântica: principal sólido, secundário com contorno ou fundo suave, terciário como link. O destrutivo só é grande e vermelho quando é a ação principal (o botão final do diálogo de confirmação).
  • Profundidade (se o sistema a admite): luz de cima; cerca de 5 sombras de duas camadas; menos bordas (separar com espaço, fundo ou sombra); borda de acento para dar cor. Sem sombras: diferenças de fundo e filetes finos.
  • Imagens: os ícones não se escalam (metê-los numa forma com fundo); as imagens carregadas por usuários vão num contentor fixo com object-fit: cover; o texto sobre uma imagem precisa de uma camada que garanta o contraste.
  • Modo escuro: redefinir os tokens semânticos, não inverter; superfícies que clareiam com a elevação; acentos menos saturados.
  • Cifras: font-variant-numeric: tabular-nums em tudo que se compara ou se atualiza.

4. Acessibilidade: o mínimo que não se negocia

WCAG 2.2 AA é o objetivo (e o que a EN 301 549 V4.1.1 da UE exige). Checklist completa com os 55 critérios A/AA, ARIA, modais, regiões vivas e receita de testes → references/accesibilidade.md.

  • HTML nativo antes que ARIA (button, a href, label, fieldset, dialog); zero div clicáveis.
  • Contraste: texto ≥ 4,5:1; texto grande (≥ 24 px, ou ≥ 18,66 px em negrito), bordas de input, ícones que informam e foco ≥ 3:1. Mede-se com a fórmula da WCAG 2.x, não com APCA.
  • Teclado completo; foco visível (:focus-visible) e não tapado por cabeçalhos ou barras fixas (scroll-padding); modais com o foco dentro, Esc e devolução do foco ao fechar.
  • Objetivos ≥ 24×24 px CSS como mínimo legal; projetar a 44–48 px em tátil.
  • Tudo que se arrasta tem alternativa sem arrastar (kanban, ordenar, sliders).
  • Erros em texto junto ao campo, com aria-invalid e aria-describedby; nada só por cor.
  • Estados assíncronos anunciados com role="status" (ou alert se forem urgentes), com a região montada de antemão.
  • Login: pode-se colar; autocomplete com username, current-password e one-time-code; sem testes cognitivos.
  • Não voltar a pedir o já introduzido no mesmo processo.
  • Reflow a 320 px sem deslocamento horizontal (exceto tabelas de dados); zoom a 200 %; prefers-reduced-motion.
  • Um axe a verde não significa acessível: no estudo do GOV.UK a melhor ferramenta encontrou ~41 % das barreiras (todas juntas, ~71 %), e a Deque calcula que o axe deteta ~57 % das incidências. É preciso também uma passagem com teclado e um teste rápido com leitor de ecrã.

5. Como trabalhar segundo a solicitação

Implementar ou melhorar UI em código

  1. Ler o sistema de design do projeto (tokens, primitivas, componentes parecidos já feitos) e reutilizar antes de criar.
  2. Escrever a necessidade, o contexto e os estados (§1).
  3. Construir primeiro a funcionalidade, com a hierarquia a cinzento; depois espaçamento, tipografia e cor com os tokens.
  4. Cobrir os estados: default, hover, focus-visible, active, disabled (com motivo), loading, vazio, erro, sucesso.
  5. Verificar: largura móvel (320–380 px) e desktop, teclado, contraste e textos longos ou dados extremos (nomes de 60 caracteres, montantes de 7 dígitos, listas de 0 e de 500 linhas). Se houver navegador disponível, olhar para o ecrã de verdade: uma captura mostra o que o código não mostra.

Rever uma tela, uma captura ou um PR

Passar §2–§4 e devolver:

  1. Resumo em 2–3 linhas: o que funciona e qual é o problema mais caro.
  2. Descobertas ordenadas por severidade (escala de Nielsen: 4 catastrófico, arranjar antes de publicar · 3 maior · 2 menor · 1 cosmético). Em cada uma: onde, que princípio viola (heurística, lei ou critério WCAG com número), a quem afeta e como, e a correção concreta (valor, componente, copy), separando o obrigatório do gosto. Declarar que a severidade é a de um único avaliador.
  3. Correções rápidas: no máximo 5, as de maior impacto e menor esforço.
  4. Perguntas abertas: o que só se resolve com dados ou com usuários.

Decidir entre alternativas

Comparar contra a tarefa principal e o contexto (§1), não por gosto. Se a diferença depende do comportamento real, dizê-lo e propor o teste mais barato que a resolveria (teste com 5 usuários, A/B, analítica): references/centrado-em-usuario.md §5.

Projetar sem código (fluxo ou wireframe)

Entregar a necessidade reformulada, o fluxo do caminho feliz com seus estados, a estrutura de cada tela justificada com um princípio por decisão e o que fica por validar com usuários.

6. Regras de comportamento

  • Concreto antes que geral: "sobe o texto secundário de gray-400 para gray-600 do Tailwind v3 (2,5:1 → 7,6:1 sobre branco; WCAG 1.4.3 pede 4,5:1)" em vez de "melhora o contraste".
  • Uma linha de porquê por recomendação, com a fonte. Se a fonte é do projeto, dizê-lo. Se é ofício, também.
  • Presunção de ignorância de quem lê: nunca se assume que "toda a gente sabe" um padrão (Hick, Miller, desabilitados, contraste…). Explicar em 2–3 palavras quando se usa.
  • Não dizer "intuitivo": a intuição é a memória de padrões aprendidos noutros sítios; se há convenção, nomeá-la.
  • Propor, não impor: as decisões de design são do projeto; esta skill fornece a base para tomá-las, mas não as toma. Evitar "devemos" ou "há que"; usar "pode-se", "recomenda-se", "o normal é". Salvo WCAG, que se diz "obrigatório" e ponto.
  • Quando não há tempo: priorizar a heurística de Nielsen 1 (estado visível), 4 (consistência) e 8 (minimalismo), mais a Lei de Fitts e o contraste mínimo. Com isto cobre-se 80 % das barreiras comuns.
  • Não redesenhar só porque se pode: se uma interface funciona para a sua tarefa, com evidência suficiente, e não pediram revisão, não se revisa.

7. Modo de emergência

Se o projeto está lançado e com dados, aplicar §1 saltando a reformulação e ir direito ao que já se vê mal. A ordem é:

  1. Erros e bloqueios (heurística 9, 5).
  2. Contraste e foco (WCAG).
  3. Estado visível (heurística 1).
  4. Tudo o resto.

Habilidades Relacionadas