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 Gustavo Silveira · · 11 min de leitura · Licença MIT
Instale com um comando
$ 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.
/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.
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.
/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?
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.
/ux-research Escreva o roteiro de entrevista para os admins que travaram.
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:
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.
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.
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.