Uma skill de UX Research para o Claude Code

A ux-research é uma skill gratuita e open source para o Claude Code que planeja pesquisa com usuários, escreve roteiros de entrevista, organiza achados brutos em insights que apontam para a evidência e entrega um brief de design para a etapa seguinte. Antes de sugerir qualquer método, ela pergunta qual decisão a pesquisa precisa informar. Construí a skill sobre três frameworks publicados: o planejamento de pesquisa de Behzod Sirjani, o Atomic Research de Daniel Pidcock e o Continuous Discovery de Teresa Torres.

Por · · 11 min de leitura · Licença MIT

Instale com um comando

Terminal
$ npx skills add Gustavosilveira23/claude-design-skills -s ux-research -g

Isso instala a skill para todos os projetos da sua máquina. Abra uma conversa nova no Claude Code e descreva um problema de pesquisa: a skill carrega sozinha. Você também pode chamá-la direto com /ux-research.

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

Nunca planejou uma pesquisa? Digite só /ux-research

Você não precisa conhecer o método nem saber qual modo escolher. Digite o comando sozinho e a skill entrevista você até aparecer uma decisão que valha uma pesquisa. Esta é a conversa que ela teve com alguém pesquisando pela primeira vez, gravada numa sessão nova do Claude Code. As respostas da skill são reais, encurtadas e traduzidas do inglês; as do usuário foram escritas para a demonstração. As palavras mudam a cada execução e seguem o seu idioma. A ordem das perguntas não muda.

Claude Code

/ux-research

No que você está trabalhando? Uma ou duas frases bastam para começar.[...]Se não souber qual modo serve, responda isto: que decisão você está tentando tomar? Se tivesse a resposta perfeita amanhã, o que faria de diferente?

Sou a única pessoa de design numa startup pequena, a gente faz um app de hábitos. Meu gestor disse que a gente devia fazer pesquisa com usuários. Acho que a ideia é só entender melhor nossos usuários.

"Entender melhor nossos usuários" não é algo que uma pesquisa consiga terminar. Dá para entrevistar gente por seis meses e ainda não saber quando parar. Veja como uma decisão poderia ficar num app de hábitos:- "Refazemos o onboarding, ou o problema de verdade está na segunda semana?"- "As pessoas somem porque esquecem de abrir o app, ou porque perdem um dia e desistem?"O que fez seu gestor levantar isso agora?

Muita gente para de usar o app depois das duas primeiras semanas. O time quer construir lembretes de sequência no próximo trimestre, mas ninguém tem certeza de que o problema é esse.

Isso é uma decisão de verdade: gastamos o próximo trimestre em lembretes de sequência, ou o abandono vem de algo que lembrete não resolve?Lembrete de sequência é uma aposta de que as pessoas saem porque esquecem. Outras explicações são igualmente plausíveis:- Perderam um dia, perderam a sequência e desistiram. Se for isso, mais lembretes podem piorar.- O app funcionou: o hábito pegou e elas não precisaram mais dele.[...]Uma checagem honesta: se a evidência disser que lembrete não é a resposta, o time está mesmo disposto a construir outra coisa?

Com três respostas, o pedido vago virou uma decisão, a solução favorita do time ganhou cinco explicações concorrentes e a skill já descreveu o slide com que o estudo deve terminar: por que as pessoas pararam, agrupado por causa, e em que posição fica "esqueci de abrir o app". Dali ela passa sozinha para o modo Plan.

Como funciona: quatro modos

A skill lê o seu pedido e escolhe um de quatro modos. Se você descrever o problema com as suas palavras, nunca precisa dizer o nome de um modo. Na maioria dos dias eu uso um de cada vez.

ModoUse quandoVocê recebe
PlanTem uma decisão a tomar e evidência insuficienteUm research brief: estágio, método, amostra, o slide que você espera mostrar
InterviewPrecisa conversar com usuáriosRoteiros de entrevista, questionários, planos de teste de usabilidade
SynthesizeTem anotações, transcrições ou dados de questionárioFatos, insights e recomendações, cada um com nível de confiança
SpecifyOs insights chegaram e o design começa em seguidaUm brief de design em que cada requisito aponta para a evidência

Os exemplos abaixo seguem um mesmo caso inventado do começo ao fim, para você ver o que cada modo devolve. A empresa e os números são fictícios.

Plan: comece pela decisão, não pelo método

A primeira coisa que a skill faz é se recusar a começar sem uma decisão. "Conhecer nossos usuários" volta com uma pergunta: se você tivesse a resposta perfeita amanhã, o que faria de diferente?

Com a decisão clara, ela passa por quatro checagens. Em que estágio o time está (Discover, Design, Develop ou Deploy). Qual o tamanho da decisão, o que Sirjani chama de splash zone: tamanho do trabalho, quem precisa participar, quem é afetado. Que tipo de evidência a decisão pede. E quais métodos são possíveis de verdade com o tempo, o tráfego e o acesso que você tem.

Prompt
/ux-research Estamos perdendo times novos antes da primeira reunião marcada. Refazemos o onboarding como configuração guiada ou consertamos o fluxo self-service?
O que volta (encurtado)
DECISÃO      Configuração guiada vs. consertar o onboarding
             self-service atual.
ESTÁGIO      Discover. Ninguém sabe ainda por que os times
             travam, então é cedo para comparar duas soluções.
SPLASH ZONE  Média. 6 a 8 semanas de trabalho, vendas e suporte
             afetados, toda conta nova passa por ali.
EVIDÊNCIA    Comportamental primeiro (onde os times param),
             depois atitudinal (por quê).
MÉTODOS      Análise do funil das etapas de configuração + 6
             entrevistas com admins que travaram nos últimos
             30 dias.
CORTADO      Teste A/B. Uns 200 cadastros por mês é pouco
             para cada variante.
O SLIDE      A etapa onde os times param, ao lado das palavras
             que eles usaram para descrevê-la.

Essa última linha é o "million dollar slide" de Sirjani: o gráfico que você espera que mude a decisão, rascunhado antes de qualquer dado chegar. Se não consegue rascunhar, você ainda não sabe o que está procurando.

Interview: roteiros que perguntam sobre o passado

As pessoas são ruins em prever o que fariam e razoáveis em contar o que fizeram. Por isso os roteiros seguem a entrevista baseada em histórias de Teresa Torres: comece pela última vez que algo aconteceu e avance no tempo.

Prompt
/ux-research Escreva o roteiro de entrevista para os admins que travaram.
O que volta (trecho)
HISTÓRIA (15-20 min)
"Pense no dia em que você cadastrou o seu time. Me conte o que
aconteceu desde o começo."
  "O que aconteceu primeiro?"
  "E depois, o que você fez?"
  "O que você estava pensando naquele momento?"

APROFUNDAMENTO
  Dor            -> "O que você fez quando isso aconteceu?"
  Gambiarra      -> "Como você chegou nesse jeito?"
  Resposta vaga  -> "Pode me dar um exemplo específico?"

Ela também reescreve as perguntas que costumam escapar para dentro dos roteiros:

Em vez deEla pergunta
"Você usaria uma configuração guiada?""Me conte da última vez que você configurou uma ferramenta para o seu time."
"Por que você parou?""O que levou você a parar ali?"
"Com que frequência você convida pessoas?""Quando foi a última vez? E antes dessa?"

O mesmo modo escreve questionários (triagem primeiro, 10 minutos no máximo) e testes de usabilidade, em que cada tarefa é um objetivo ("marque uma reunião com dois colegas") e não uma lista de cliques.

Synthesize: de fatos a insights com Atomic Research

É o modo que eu mais uso. Ele organiza o que você coletou nos quatro níveis de Daniel Pidcock:

  • Experimento: o que você fez. "6 entrevistas e uma análise de funil, outubro."
  • Fato: o que você encontrou, sem interpretação.
  • Insight: o que um grupo de fatos significa.
  • Recomendação: o que fazer a respeito.

A regra que faz funcionar: nenhum insight sem fatos por trás, e nenhuma recomendação sem um insight. Se a corrente quebra, a recomendação é opinião. Cada insight também recebe um nível de confiança. Um fato de uma fonte é BAIXA. Dois ou três da mesma fonte é MÉDIA. Três ou mais de fontes diferentes é ALTA.

O que volta (dados fictícios)
EXPERIMENTO  6 entrevistas com admins que travaram
             + análise do funil de configuração, out.

FATO 1  5 de 6 admins pararam em "Conecte sua agenda".
FATO 2  P4: "Eu não queria dar acesso à agenda de todo mundo
        antes de saber se funcionava."
FATO 3  58% das contas novas nunca passam da etapa da agenda
        (funil).
FATO 4  3 de 6 só voltaram depois que um colega disse que
        era seguro.

INSIGHT  Admins não liberam acesso à agenda antes de ver o
         produto funcionando.
         Confiança: ALTA (4 fatos, 2 fontes)

RECOMENDAÇÃO  Deixar o admin marcar uma reunião de teste com
              dados de exemplo antes de pedir acesso à agenda.
              Esperado: mais contas passam dessa etapa.
              Medida: taxa de conclusão dessa etapa.

Repare na recomendação. Ela não é "guiada" nem "self-service". A evidência mudou a pergunta, e é para isso que se pesquisa antes de escolher.

A skill termina toda síntese com um lembrete de voltar aos dados brutos. A próxima seção explica por quê.

Specify: um brief de design rastreável até a evidência

Quando os insights estão sólidos, este modo escreve o brief para quem desenha em seguida. No meu setup é a skill ux-designer, mas o brief serve para uma pessoa também.

O que volta (trecho)
BRIEF DE DESIGN  Permissão de agenda no onboarding

DECISÃO    Configuração guiada vs. consertar o self-service
           (reformulada pela pesquisa).

OBRIGATÓRIO
  1. Uma reunião de teste funcionando antes de pedir permissão
     Base: Insight 1 (fatos 1, 2, 3, 4), ALTA

PREMISSA (confiança BAIXA, validar antes de construir)
  2. Mostrar quais dados da agenda lemos vai reduzir o abandono
     Base: 1 citação. Teste mais barato: 5 sessões de usabilidade.

SUCESSO    Principal: conclusão da etapa da agenda.
           Proteção: tickets de suporte sobre permissão não sobem.

Tudo o que não se rastreia até um fato vira premissa, com o jeito mais barato de testar. Um brief que esconde os pontos fracos é construído do mesmo jeito, e aí o ponto fraco aparece em produção.

Onde a IA ajuda e onde ela falha na pesquisa com usuários

A IA é rápida em estrutura: rascunhar um roteiro, agrupar centenas de anotações, conferir se cada recomendação tem evidência por trás. Ela não é confiável na etapa que mais importa, que é entender o que as pessoas quiseram dizer.

O Nielsen Norman Group foi direto no guia sobre pesquisa com IA: o modelo "pode deixar passar, interpretar errado ou até fabricar insights", e ao codificar transcrições "muitas vezes ignora trechos grandes onde os códigos deveriam ser aplicados" (Moran e Rosala, NN/g, tradução minha).

Por isso a skill foi construída em torno desse limite:

  • Ela estrutura e confere. Nunca trata a própria leitura de uma entrevista como palavra final.
  • Toda síntese termina com um aviso para revisar os dados brutos.
  • Ela mantém as citações literais, porque uma paráfrase já é uma interpretação.
  • Ela questiona pesquisa feita para confirmar uma decisão já tomada. Se o time já decidiu, ela diz isso: pule a pesquisa e lance.

Sobre tamanho de amostra, ela vai na contramão da maioria das ferramentas de IA. Não deixa uma decisão pequena esperar por um estudo grande. Cinco entrevistas bastam para muitas decisões, e cinco sessões de usabilidade encontram a maior parte dos problemas de um fluxo (Nielsen, 2000).

Frameworks e créditos

O método vem de quem o publicou primeiro. O trabalho da skill é combinar os três para que o Claude aplique todos na mesma conversa.

  • Planejamento de pesquisa: Behzod Sirjani (Reforge). Decisão primeiro, splash zone, mapa de evidências, o million dollar slide.
  • Atomic Research: Daniel Pidcock. Experimento, fato, insight, recomendação.
  • Continuous Discovery: Teresa Torres. Entrevista baseada em histórias e a opportunity solution tree.

Os créditos completos estão no README do repositório.

Perguntas frequentes

O que é uma skill do Claude Code?

Uma pasta com instruções e arquivos de referência que o Claude carrega quando o seu pedido combina com o que a skill cobre. Ela muda como o Claude trabalha nesse tipo de tarefa sem você colar um prompt longo toda vez.

Preciso do Claude Code ou funciona no claude.ai?

Nos dois. No Claude Code, instale com o comando acima. No claude.ai, compacte a pasta ux-research em zip e envie em Customize > Skills, com a execução de código ligada. Também funciona em outros agentes compatíveis com Agent Skills, como Cursor e Codex.

Nunca fiz pesquisa com usuários. Por onde começo?

Pela decisão, não pelo método. Escreva o que o seu time vai construir ou mudar dependendo da resposta. Se não conseguir, digite /ux-research sem nada depois: a skill faz perguntas até a decisão ficar clara e então sugere o menor estudo capaz de respondê-la, muitas vezes cinco ou seis entrevistas.

A IA pode substituir um UX researcher?

Não. Ela rascunha, organiza e confere, e faz isso rápido. Decidir o que um padrão significa e o que o time deve fazer a respeito ainda exige uma pessoa que leu os dados brutos. A skill foi feita para manter essa etapa humana.

Posso usar o Claude para sintetizar entrevistas com usuários?

Sim, para a estrutura. Cole as anotações ou transcrições e use o modo Synthesize: ele separa fato de interpretação, agrupa em insights e dá uma nota de confiança para cada um. Depois confira você mesmo os insights contra as transcrições, porque a IA pode pular trechos inteiros de uma conversa.

O que é atomic research?

Um jeito de guardar pesquisa em pedaços pequenos e ligados entre si, em vez de relatórios. Daniel Pidcock definiu quatro níveis: experimento, fato, insight e recomendação. Um fato pode sustentar vários insights, e estudos novos somam fatos a insights antigos, então o conhecimento se acumula entre projetos.

Qual a diferença entre fato e insight?

Fato é o que aconteceu: "5 de 6 admins pararam na etapa da agenda." Insight é o que isso significa: "admins não liberam acesso antes de confiar no produto." Se duas pessoas podem ler os mesmos dados e discordar, você já passou do fato para o insight.

Quantos usuários devo entrevistar?

Depende do tamanho da decisão. Para uma decisão pequena, 3 a 5 entrevistas costumam bastar. Para uma maior, planeje 5 a 8 por segmento de usuário. Em teste de usabilidade, 5 participantes encontram a maior parte dos problemas de um fluxo.

O que entra num plano de pesquisa UX?

A decisão que ele informa, o estágio do produto, o tamanho da decisão, o que você precisa aprender (obrigatório, desejável, bom saber), o método e os participantes, o resultado esperado e o que a pesquisa não vai responder. O modo Plan escreve isso como um research brief.