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 · · 12 min de leitura · Licença MIT

Instale com um comando

Terminal
$ 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.

Claude Code

/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.

O que voltou (encurtado)
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.

Claude Code

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.

DimensãoNotaProblema principal
Copy1/5Descreve o que o sistema precisa, não o que o admin ganha. Códigos de permissão crus, um botão "Enviar" e um "Error 403" falso.
Layout2/5Duas ações (escolher e depois Enviar) onde uma bastaria. Sem Voltar nem Pular.
Emphasis2/5A escolha do provedor parece um par de caixas comuns. O elemento mais forte é um botão que sozinho não faz nada.
Accessibility1/5Os provedores não são alcançáveis pelo teclado. 4 de 6 pares de cor reprovam no contraste.
Reward1/5Nenhum benefício dito antes do pedido, e nenhum retorno quando você clica.
Total7/25Pede acesso amplo antes de mostrar que qualquer coisa funciona.
Achados críticos (encurtado)
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.

Gustavo Silveira

Product designer sênior. Desenhei produtos na Hotmart e na Sympla e hoje trabalho com produtos de IA. Está construindo um? Vamos conversar.