Uma skill de UX Design para o Claude Code
A ux-designer é uma skill gratuita e open source para o Claude Code que faz o Claude perguntar quem usa uma interface antes de construí-la, apresentar a estratégia de UX antes de escrever código, discordar de pedidos que piorariam a experiência e auditar telas existentes com uma nota de 0 a 10 ou com o scorecard CLEAR. Ela também confere o que interfaces geradas por IA costumam esquecer: estados vazios e de erro, microcopy, acesso por teclado e área de toque.
Por Gustavo Silveira · · 12 min de leitura · Licença MIT
Instale com um comando
$ npx skills add Gustavosilveira23/claude-design-skills -s ux-designer -g
Isso instala a skill para todos os projetos da sua máquina. Peça ao Claude Code para desenhar, revisar ou consertar qualquer coisa que uma pessoa usa, e a skill carrega sozinha. Você também pode chamá-la direto com /ux-designer, seguido de uma URL, do nome de um componente ou do caminho de um arquivo.
O mesmo comando funciona no Cursor, no Codex e em outros agentes que leem o formato Agent Skills. No claude.ai, compacte a pasta ux-designer em zip e envie em Customize > Skills, com a execução de código ligada. O código fica em github.com/Gustavosilveira23/claude-design-skills, com licença MIT, junto de outras cinco skills de design.
Ela pergunta antes de construir
Peça à maioria das ferramentas de IA para desenhar a etapa da agenda de um onboarding e você recebe uma tela. Esta skill para antes. Enquanto não sabe quem usa a interface, que problema ela resolve e quais são as restrições, ela pergunta em vez de construir.
Para mostrar, continuei o caso do guia da ux-research. Lá, a pesquisa sobre uma ferramenta de agendamento descobriu que admins novos não conectam a agenda antes de ver o produto funcionando, e a skill escreveu um brief de design cujo único item obrigatório era uma reunião de teste funcionando antes de qualquer pedido de permissão. Aqui, esse brief vai para a ux-designer. Gravei numa sessão nova do Claude Code, só com esta skill instalada. As respostas da skill são reais, encurtadas e traduzidas do inglês; as falas do usuário foram escritas para a demonstração.
/ux-designer Aqui está o brief de design da nossa pesquisa sobre por que admins novos travam no onboarding. Você pode desenhar a etapa de conectar a agenda? [brief colado]
O brief diz o que construir. Ele deixa de fora algumas coisas que mudariam o design, então tenho perguntas antes de começar.[...]1. O que fez os admins travarem? "Não confiam a agenda a nós", "ainda não veem valor" e "a TI precisa aprovar" levam, cada um, a uma tela diferente.2. Como funciona uma reunião de teste antes de termos acesso à agenda? O item obrigatório depende disso.3. Quem concede a permissão? A própria agenda, com um clique de OAuth, ou o consentimento da empresa inteira, dado por um admin de TI?4. O que o "reformulada pela pesquisa" decidiu?5. Desktop ou celular? Existe design system? Você quer um protótipo, um arquivo no Figma ou uma spec de fluxo e estados?Se só tiver tempo para duas, responda a 1 e a 2.
1. Eles não conectam antes de ver funcionando. 5 de 6 pararam em "Conecte sua agenda". Um disse: "Eu não queria dar acesso à agenda de todo mundo antes de saber se funcionava." 3 de 6 voltaram depois que um colega disse que era seguro. 2. Eles podem marcar um horário na própria página, com o horário padrão, e recebem o e-mail de confirmação. 3. Quase sempre a própria agenda. Algumas empresas maiores precisam de consentimento da TI. 4. Mostrar funcionando primeiro. 5. Desktop, temos design system, uma spec de fluxo e estados basta.
Cada pergunta muda o design. A 3 é a que os times mais pulam: se o consentimento depende de um admin de TI, parte desta etapa vira "mande isto para a pessoa da TI", e nenhum layout de tela resolve isso.
Estratégia antes do código
Com as respostas, a skill apresenta a estratégia num formato fixo e espera aprovação antes de escrever spec ou código. Um ajuste rápido ganha uma frase. Um fluxo novo ganha o modelo inteiro.
ESTRATÉGIA DE UX Etapa de conectar a agenda
USUÁRIO Um admin novo na mesa de trabalho, avaliando a
ferramenta. Cauteloso: sente que está dando aval
a ela para o time.
INSIGHT A confiança vem de ver funcionando. Conectar a
agenda deve resolver um problema que ele acabou
de ver.
DECISÕES
1. Reunião de teste primeiro, como "experimente sua página".
2. O motivo para conectar vem do que ele viu:
"Esta reunião ainda não está na sua agenda."
3. Uma linha sobre o alcance: "Conecta só a sua agenda.
As agendas do seu time continuam privadas."
4. "Pular por enquanto" é uma saída real. A página fica no ar.
5. Uma página curta para encaminhar à TI ou a um colega.
MAIOR RISCO A reunião de teste satisfaz, e ele sai sem
conectar.Dois detalhes vieram de ler a evidência com atenção. A citação dizia "a agenda de todo mundo", mas o clique de OAuth só dá acesso à agenda do próprio admin, então parte do medo é de algo que o produto nem faz. Isso virou a decisão 3. E ela apontou o próprio ponto fraco: uma reunião de teste tão boa que ninguém se dá ao trabalho de conectar. A mensagem depois da reunião está lá para fechar essa brecha.
Ela discorda
Aí o usuário da demonstração trouxe um pedido do PM: tirar o "Pular por enquanto", porque uma etapa obrigatória aumentaria a conclusão da etapa da agenda, a métrica principal do brief.
Meu PM quer tirar o "Pular por enquanto". Se a etapa da agenda for obrigatória, a conclusão dessa etapa sobe, e essa é a nossa métrica principal. Dá para fazer isso?
Dá, mas eu discordaria. A métrica provavelmente subiria enquanto o resultado real piora.1. Muda quem entra no número. Admins que não querem conectar não passam a confiar em nós porque o botão de pular sumiu. Eles saem do onboarding, e a conclusão sobe porque quem duvidava foi embora.2. A sua própria pesquisa diz que quem duvida volta. 3 de 6 voltaram depois que um colega disse que era seguro. O pular é o que permite essa volta.3. Alguns admins não conseguem conectar de jeito nenhum. Quem depende da TI fica bloqueado e vira os tickets de suporte que a sua métrica de proteção vigia.4. É o mesmo erro que a pesquisa encontrou, uma etapa depois.Em vez disso: mantenha o pular como um link discreto, pergunte "O que está impedindo você?" quando alguém pular, e exija a agenda conectada mais tarde, quando a pessoa for compartilhar a página com gente de verdade. Se o PM ainda quiser obrigatório, faça um teste A/B medido pelas contas com agenda conectada depois de 7 dias.
As instruções da skill terminam com uma linha: defenda a pessoa do outro lado da tela. Na prática, isso é discordar com motivos tirados do brief, oferecer outra coisa a fazer e propor um teste quando a discussão não resolve.
Auditorias: nota de 0 a 10 ou scorecard CLEAR
Aponte a skill para uma tela existente e ela audita em um de dois formatos. O rápido é uma nota de 0 a 10, com os achados separados em crítico, importante e acabamento, mais o que está funcionando. O detalhado é um scorecard adaptado do framework CLEAR UI, do Growth.Design: Copy, Layout, Emphasis, Accessibility e Reward, cada um com nota de 1 a 5, cruzado depois com o ELMR para a ação principal.
Na sessão, pedi a auditoria detalhada da etapa da agenda que a ferramenta tem hoje. Essa tela é fictícia, escrita para a demonstração de acordo com o que o brief descreve: o pedido de permissão primeiro, escrito do ponto de vista do sistema.
1. Pede antes de provar qualquer coisa. Esta é a tela onde 5 de 6 admins pararam. 2. Clicar num provedor não muda nada na tela. 3. Quem usa teclado ou leitor de tela não consegue conectar: os provedores são divs com clique, não botões. 4. Não escolher provedor mostra "Error 403: insufficient_permissions". Nada foi negado. Admins já nervosos com permissão veem um erro de permissão. 5. Uma permissão, admin.directory.resource.calendar, parece dar acesso à organização inteira. PERGUNTA PARA A ENGENHARIA O onboarding precisa da permissão de salas de reunião? Permissões de diretório costumam exigir aprovação da TI.
O achado 4 é do tipo que checklist não pega: uma mensagem de erro dizendo a uma pessoa nervosa que aquilo que ela teme acabou de acontecer. A skill também disse o que não conseguiu conferir. Calculou o contraste à mão, porque rodar um script precisava de aprovação, e não deu nota às telas depois do redirecionamento para o Google ou a Microsoft, porque elas não estavam no arquivo.
O que ela confere enquanto desenha
Entre a estratégia e a auditoria, a skill faz as mesmas conferências em tudo o que desenha. Estas são as que pegam o que interfaces geradas por IA costumam esquecer:
- Estados, não só o caminho feliz. Vazio, carregando, erro e sucesso, mais os casos de borda: zero itens, mil itens, nomes longos, dado faltando. Toda etapa de um fluxo precisa de uma saída.
- Microcopy. Botões dizem o resultado ("Conectar Google Agenda", nunca "Enviar"). Erros dizem o que aconteceu, por que e o que fazer. Diálogos de confirmação nomeiam as duas ações.
- Acessibilidade. Contraste de texto de pelo menos 4,5:1 (WCAG AA), botões de verdade em vez de divs clicáveis, foco visível e
prefers-reduced-motion. A área de toque mira em 44x44 pt e nunca fica abaixo do piso da WCAG AA, de 24x24 pixels CSS. - Psicologia, com fonte. A memória de trabalho guarda cerca de quatro blocos de informação (Cowan, 2001). Mais opções deixam a decisão mais lenta (lei de Hick). As pessoas julgam uma experiência pelo pico e pelo final (Kahneman et al., 1993).
- Tempo de resposta. Uma resposta em até 0,1 segundo parece instantânea. Passando de uns 10 segundos, mostre uma barra de progresso com porcentagem (Nielsen, 1993).
- Animação com motivo. Toda animação precisa responder a uma pergunta: de onde isto veio, o que mudou, minha ação funcionou. A maioria das animações de interface fica entre 100 e 500 ms (NN/g).
Antes de escrever este guia, conferi cada número da skill na fonte primária. Dez estavam errados, desatualizados ou sem fonte. Um dizia que conteúdo alinhado à esquerda recebe 30% mais atenção; o estudo por trás dele mediu 30% do tempo de leitura na metade direita da página, em 2010. O número atual é de cerca de 80% na metade esquerda (NN/g, 2017). Os dez estão corrigidos na skill.
Onde a IA falha na revisão de UX
A pesquisa sobre auditoria com IA aponta para o mesmo lado: os modelos encontram parte dos problemas reais e inventam outros. Quanto de cada um depende do método.
Em 2023, o Baymard Institute deu ao ChatGPT-4 screenshots de 12 páginas de e-commerce e comparou as sugestões dele com as de seis especialistas que revisaram as páginas ao vivo. 80% das sugestões da IA estavam erradas. Ela encontrou 14% dos problemas das páginas ao vivo e 26% dos que apareciam nos screenshots (Holst, Baymard, 2023).
Um estudo de 2025 chegou a uma cobertura bem maior com um prompt estruturado sobre as heurísticas de Nielsen: o GPT-4 encontrou 73% e 77% dos problemas de usabilidade de dois apps de celular, mais do que cinco avaliadores experientes somados (57% e 63%). Também apontou 95 itens que não eram problemas, contra 9 dos especialistas, e teve dificuldade com problemas que atravessam várias telas (Zhong, McDonald e Hsieh, 2025). Os dois estudos medem coisas diferentes, então não mostram a IA indo de 14% para 77%.
Daniela Napoli, pesquisadora de UX que criou a própria skill de avaliação heurística, testou no próprio site, onde conhecia o motivo de cada decisão. O resumo dela: o Claude "apontou com confiança problemas que não existiam", principalmente em conteúdo dinâmico e em caminhos que não conseguia verificar (Napoli, 2026, tradução minha).
Por isso a skill foi construída em torno desse limite:
- Ela pergunta quem usa a tela antes de julgá-la, então cada achado fica ligado a uma pessoa e a um objetivo, e não a uma boa prática genérica.
- Ela diz o que não conseguiu conferir. Na demonstração, avisou do contraste calculado à mão e das telas que nunca viu.
- Toda revisão termina com o que testar: a premissa mais arriscada e o jeito mais barato de conferi-la com usuários reais.
Trate a auditoria dela como uma primeira passada. Cada achado é uma hipótese para conferir na tela de verdade, e os que importam vão para os usuários.
Frameworks e créditos
A skill combina frameworks que outras pessoas publicaram primeiro. O trabalho dela é fazer o Claude aplicá-los na mesma conversa, no momento em que importam.
- ELMR (Emotion, Logic, Motivation, Reward): do material de psicologia do usuário da Reforge, atribuído a Brian Balfour em fontes secundárias. A lição original fica atrás do login da Reforge.
- CLEAR (Copy, Layout, Emphasis, Accessibility, Reward): Growth.Design, curso CLEAR UI. A escala de 1 a 5 e os critérios da skill são adaptação minha, não o material do curso.
- Laws of UX: Jon Yablonski, para as leis de Hick, Fitts e Jakob e a regra do pico e fim, cada uma com link para o artigo original.
- Atenção, tempo de resposta e animação: pesquisas do Nielsen Norman Group, citadas com data na skill.
Os créditos completos estão no README do repositório.
Perguntas frequentes
Qual a diferença entre uma skill e um prompt?
Um prompt dura uma conversa. Uma skill é uma pasta com instruções e arquivos de referência que o Claude carrega sozinho sempre que o pedido combina, em qualquer projeto. Esta tem cerca de 1.200 linhas, mais do que alguém colaria num chat.
Preciso saber programar?
Não. A skill funciona do mesmo jeito quando você pede uma estratégia, uma spec de fluxo ou a auditoria de um screenshot. O Claude Code roda no terminal, mas você conversa com ele em linguagem comum. Se preferir não usar o terminal, envie a pasta da skill no claude.ai, em Customize > Skills.
A IA consegue fazer auditoria de UX? É confiável?
Como primeira passada, sim. Os estudos mostram que os modelos encontram parte dos problemas reais e apontam outros que não existem: no teste do Baymard em 2023, 80% das sugestões do ChatGPT-4 estavam erradas. Trate cada achado como hipótese, confira na tela de verdade e teste os importantes com usuários.
Isso é uma avaliação heurística?
No sentido estrito, não. Uma avaliação heurística confere a tela contra uma lista fixa, em geral as 10 heurísticas de usabilidade de Jakob Nielsen. Esta skill audita com nota de 0 a 10 ou com o scorecard CLEAR, mais as leis de UX e um checklist de estados, copy e acessibilidade. Se o seu time precisa de um relatório pelas heurísticas de Nielsen, peça isso explicitamente.
Como faço o Claude perguntar antes de construir?
Instale esta skill: perguntar é o primeiro passo dela, e ela só pula quando você já respondeu às três perguntas (quem usa, que problema resolve, quais são as restrições). Sem a skill, comece o pedido com essas três respostas ou diga ao Claude para entrevistar você antes de escrever qualquer código.
Funciona no Cursor ou no Codex?
Sim. O comando de instalação funciona nos agentes que leem o formato Agent Skills, incluindo Cursor e Codex. No claude.ai, compacte a pasta ux-designer em zip e envie em Customize > Skills.
Dá para usar junto com as outras skills de design?
É assim que eu uso. A ux-research reúne a evidência e escreve o brief, a ux-designer desenha o fluxo a partir dele e a ui-designer cuida do acabamento visual. Cada uma passa para a seguinte e avisa quando outra serve melhor. As seis estão no índice.
O que são ELMR e CLEAR?
Duas lentes sobre a mesma tela. O ELMR, da Reforge, olha para a ação principal: o que a pessoa deve sentir (Emotion), o que a convence (Logic), o que facilita (Motivation) e o que ela ganha (Reward). O CLEAR, do Growth.Design, dá nota à tela em si: Copy, Layout, Emphasis, Accessibility e Reward.