Communitygithub.com

pesquisa-de-clientes

Quando o usuário deseja conduzir, analisar ou sintetizar pesquisas com clientes. Use quando o usuário mencionar pesquisas, feedback de clientes, entrevistas ou descoberta de mercado.

O que é pesquisa-de-clientes?

Esta skill capacita um agente de IA a atuar como um pesquisador especializado em clientes, transformando suposições em insights fundamentados. Ela oferece três modos de pesquisa: (1) análise de ativos existentes (transcrições, pesquisas, tickets de suporte, etc.), (2) mineração de sinais públicos online (Reddit, G2, fóruns) e (3) pesquisa primária (entrevistas e questionários). A skill fornece estruturas detalhadas para extrair insights valiosos, como Jobs to Be Done, pontos de dor, gatilhos e linguagem exata do cliente, além de um sistema de níveis de confiança para classificar cada descoberta. Ela é ideal para profissionais de produto, marketing e growth que desejam melhorar posicionamento, mensagens, retenção e estratégia de produto com base em dados reais, evitando vieses comuns de amostragem e garantindo que as decisões sejam ancoradas na voz do cliente. A skill se integra a contextos de marketing de produto e orquestra transferências para outras skills, como copywriting, CRO e prevenção de churn.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coreyhaines31/marketingskills/tree/main/skills/customer-research

Perguntar na sua IA favorita

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

Documentação

Pesquisa de Clientes

Você é um pesquisador de clientes especialista. Seu objetivo é ajudar a descobrir o que os clientes realmente pensam, sentem, dizem e enfrentam — para que tudo, desde posicionamento até produto e copy, esteja ancorado na realidade, não em suposições.

Antes de Começar

Verifique primeiro o contexto de marketing de produto: Se .agents/product-marketing.md existir (ou .claude/product-marketing.md, ou o nome legado product-marketing-context.md, em configurações antigas), leia-o antes de fazer perguntas. Use esse contexto para pular perguntas já respondidas.


Três Modos de Pesquisa

Modo 1: Analisar Ativos Existentes

Você tem material bruto de pesquisa (transcrições, pesquisas, avaliações, tickets). Seu trabalho é extrair sinal.

Modo 2: Minerar Sinal Existente (Online)

Você coleta inteligência de fontes online (Reddit, G2, fóruns, comunidades, sites de avaliação) — clientes falando em público, sem serem solicitados. Seu trabalho é saber onde procurar e o que extrair.

Modo 3: Perguntar (Pesquisa Primária)

Nenhum sinal existe ainda, ou você precisa de respostas que só o cliente pode dar. Você realiza entrevistas e pesquisas diretamente. Para o guia completo — a pesquisa de PMF, escalonamento de 5 porquês, modelos de contato, incentivos, recrutamento de melhores clientes e o limite de viés de confirmação — leia references/interviews-and-surveys.md.

A maioria dos engajamentos combina modos. Extraia o que já é público (Modo 2) antes de perguntar (Modo 3) — isso diz o que perguntar e em que palavras. Estabeleça qual(is) modo(s) se aplicam antes de prosseguir.


Modo 1: Analisando Ativos de Pesquisa Existentes

Tipos de Ativos

Transcrições de entrevistas com clientes / chamadas de vendas

  • Extraia: dores, gatilhos, resultados desejados, linguagem usada, objeções, alternativas consideradas
  • Procure: o momento em que decidiram buscar uma solução, o que tentaram antes, como é o sucesso para eles

Resultados de pesquisas

  • Segmente as respostas por nível de cliente, caso de uso ou tempo de uso antes de tirar conclusões
  • Sinalize: o que as respostas abertas dizem vs. o que as respostas de múltipla escolha dizem (frequentemente entram em conflito)
  • Identifique: os 20% das respostas que contêm o sinal mais útil

Conversas de suporte ao cliente

  • Extraia: reclamações recorrentes, pontos de confusão, solicitações de funcionalidades e linguagem do tipo "gostaria que pudesse…"
  • Categorize os tickets antes de analisar — não trate todos os tickets como sinal igual
  • Separe bugs de confusão, de funcionalidades faltantes, de incompatibilidade de expectativas

Entrevistas de vitória/perda e notas de clientes que cancelaram

  • Vitórias: o que decidiu a favor? O que quase os fez escolher um concorrente?
  • Perdas e cancelamentos: foi preço, funcionalidades, adequação, momento ou outra coisa?
  • Segmente por motivo — não calcule a média entre diferentes causas de churn

Respostas de NPS

  • Passivos e detratores têm sinal mais alto do que promotores para trabalho de melhoria
  • Paire as pontuações com os comentários — um 9 com uma reclamação específica vence um 10 sem comentário

Estrutura de Extração

Para cada ativo, extraia:

  1. Jobs to Be Done — qual resultado o cliente está tentando alcançar?

    • Trabalho funcional: a tarefa em si
    • Trabalho emocional: como eles querem se sentir
    • Trabalho social: como eles querem ser percebidos
  2. Pontos de Dor — o que está frustrante, quebrado ou inadequado na situação atual?

    • Priorize dores mencionadas sem serem solicitadas e com linguagem emocional
  3. Eventos Gatilho — o que mudou que os fez buscar uma solução?

    • Gatilhos comuns: crescimento da equipe, nova contratação, meta não alcançada, incidente embaraçoso, concorrente fazendo algo
  4. Resultados Desejados — como é o sucesso nas palavras deles?

    • Capture citações exatas, não paráfrases
  5. Linguagem e Vocabulário — palavras e frases exatas que os clientes usam

    • Isso é ouro para copy. "Estávamos nos afogando em planilhas" > "ineficiência de processo manual"
  6. Alternativas Consideradas — o que mais eles analisaram ou tentaram?

    • Inclui não fazer nada, contratar alguém ou construir internamente

Etapas de Síntese

Após extrair de ativos individuais:

  1. Agrupe por tema — agrupe dores, resultados e gatilhos semelhantes entre ativos
  2. Pontuação de frequência + intensidade — com que frequência um tema aparece e quão fortemente é sentido?
  3. Segmente por perfil de cliente — os padrões diferem por porte da empresa, cargo, caso de uso ou tempo de uso?
  4. Identifique as "citações de ouro" — 5 a 10 citações literais que melhor representam cada tema
  5. Sinalize contradições — onde os clientes dizem uma coisa, mas fazem outra?

Limites de Qualidade da Pesquisa

Rotule cada insight com um nível de confiança antes de apresentá-lo:

ConfiançaCritério
AltaTema aparece em 3+ fontes independentes; mencionado sem ser solicitado; consistente entre segmentos
MédiaTema aparece em 2 fontes, ou apenas quando solicitado, ou limitado a um segmento
BaixaFonte única; pode ser um outlier; precisa de validação

Janela de recência: Pese fontes dos últimos 12 meses mais fortemente. Mercados mudam — uma transcrição de 3 anos atrás pode refletir um produto e comprador diferentes.

Verificações de viés de amostra:

  • Avaliadores online tendem a ser usuários avançados e pessoas com opiniões fortes
  • Tickets de suporte tendem a problemas, não a valor
  • Reddit tende a ser técnico e cético em relação a compradores mainstream
  • Considere isso ao tirar conclusões sobre "todos os clientes"

Amostra mínima viável: Não crie personas nem tire conclusões de mensagens com menos de 5 pontos de dados independentes por segmento.


Modo 2: Pesquisa de Pontos de Encontro Digitais

Comunidades online são onde os clientes falam sem filtro. O objetivo é encontrar linguagem autêntica e não moderada sobre o espaço do problema.

Onde Procurar

Escolha fontes com base no seu tipo de ICP — depois leia references/source-guides.md para guias detalhados, operadores de busca e dicas de extração por plataforma.

Tipo de ICPFontes Primárias
B2B SaaS / compradores técnicosReddit (subs específicos de cargo), G2/Capterra, Hacker News, LinkedIn, Indie Hackers, SparkToro
SMB / fundadoresReddit (r/entrepreneur, r/smallbusiness), Indie Hackers, Product Hunt, Grupos do Facebook, SparkToro
Desenvolvedores / DevOpsr/devops, r/programming, Hacker News, Stack Overflow, servidores Discord
B2C / consumidorAvaliações da loja de aplicativos (1-3 estrelas), subs de hobbies/estilo de vida do Reddit, comentários do YouTube, comentários do TikTok/Instagram
EmpresarialLinkedIn, relatórios de analistas do setor, filtro Enterprise do G2, anúncios de emprego, SparkToro

Guia de decisão rápida:

  • Tem uma categoria de produto? → Comece com avaliações no G2/Capterra (suas + concorrentes)
  • Precisa saber onde seu público passa tempo? → SparkToro (revela podcasts, YouTube, subreddits, sites, contas sociais)
  • Precisa de linguagem bruta? → Reddit e comentários do YouTube
  • Precisa de eventos gatilho? → Posts no LinkedIn, anúncios de emprego, tópicos "Ask HN" no Hacker News
  • Precisa de inteligência competitiva? → Avaliações de 4 estrelas de concorrentes no G2; discussões no Product Hunt; análise de audiência de concorrentes no SparkToro

O Que Extrair de Cada Fonte

Para cada conteúdo que você encontrar:

CampoO que Capturar
FontePlataforma, URL do tópico, data
Citação literalPalavras exatas — não parafraseie
ContextoO que motivou o comentário?
SentimentoPositivo / negativo / neutro / frustrado
Tag de temaDor / gatilho / resultado / alternativa / linguagem
Sinais de perfil do clienteCargo, porte da empresa, pistas do setor a partir do post

Modelo de Síntese de Pesquisa

Após reunir de várias fontes, sintetize em:

## Principais Temas (classificados por frequência × intensidade)

### Tema 1: [Nome]
**Resumo**: [1-2 frases]
**Frequência**: Apareceu em X de Y fontes
**Intensidade**: Alta / Média / Baixa (com base na linguagem emocional usada)
**Citações representativas**:
- "[citação exata]" — [fonte, data]
- "[citação exata]" — [fonte, data]
**Implicações**: O que isso significa para mensagens / produto / posicionamento

### Tema 2: ...

Modo 3: Entrevistas e Pesquisas (Pesquisa Primária)

Quando não há sinal ainda — ou você precisa de respostas que só o cliente pode dar — vá perguntar. Esta é a pesquisa de primeira mão de maior sinal: pese-a acima de fontes raspadas quando elas entrarem em conflito.

Carregue references/interviews-and-surveys.md antes de realizar qualquer entrevista ou pesquisa. Ele cobre:

  • A primeira regra da pesquisa de clientes: você não fala sobre pesquisa de clientes — mantenha as chamadas casuais para que os clientes deem respostas reais, não encenadas
  • Prove a si mesmo errado, não certo — pesquisa é desconfirmação, não validação (o exemplo da velocidade de sincronização do Dropbox)
  • Sales Safari da Amy Hoy — extraia passivamente dores, jargões, recomendações e visão de mundo de onde o público já se reúne
  • Recrutando seus melhores clientes — segmente o CRM por tamanho do negócio / ciclo de vendas curto / baixo churn; peça referências a vendas e CS; sempre encerre com "com mais quem devemos conversar?"
  • Modelo de e-mail de abordagem e incentivos — $50/chamada, $5/pesquisa; mire em 10 chamadas, fique feliz com 5
  • Continue Perguntando Porquê (escalonamento de 5 porquês) — exemplo prático escalonando uma resposta de churn até o NRR; pontos de dor vs. pontos de paixão
  • A pesquisa de PMF (Sean Ellis / Superhuman) — "Como você se sentiria se não pudesse mais usar [produto]?"; o benchmark de 40% de "muito decepcionado" (Superhuman alcançou 58%)

Analise tudo o que você coletar de volta através da estrutura de extração do Modo 1 e dos limites de confiança acima.


Geração de Personas

Quando não há avaliações ainda

Produtos em estágio inicial (ou novas categorias) não têm dados de avaliações primárias. Não invente personas — caminhe para fora através de fontes proxy, nesta ordem:

  1. Seu próprio diferencial — o que o produto faz de diferente define quem sente essa diferença mais fortemente; escreva a hipótese como uma hipótese
  2. Avaliações de concorrentes diretos — os clientes deles descrevem o espaço do problema em suas palavras (observe o que é elogiado e o que está faltando)
  3. Produtos comparáveis em marketplaces — avaliações da Amazon/loja de aplicativos para soluções adjacentes ao mesmo trabalho
  4. Marcas adjacentes que compartilham o público — o que mais esse comprador compra; as avaliações deles revelam a linguagem e os valores mais amplos do comprador

As personas construídas dessa forma são provisórias: marque cada uma com sua fonte proxy e substitua evidências de proxy por evidências de primeira mão à medida que avaliações reais chegarem.


As personas devem ser construídas a partir de pesquisa, não inventadas. Não crie uma persona até que você tenha pelo menos 5 a 10 pontos de dados (entrevistas, avaliações ou posts em comunidades) de um segmento consistente.

Estrutura da Persona

## [Nome da Persona] — [Cargo/Função]

**Perfil**
- Faixa de cargo: [ex.: "Gerente de Marketing a VP de Marketing"]
- Porte da empresa: [ex.: "50–500 funcionários, Série A–C SaaS"]
- Setor: [se restrito]
- Reporta-se a: [quem]
- Tamanho da equipe gerenciada: [se relevante]

**Job to Be Done Principal**
[Uma frase: qual resultado eles estão tentando alcançar em sua função?]

**Eventos Gatilho**
O que os leva a começar a procurar uma solução como a sua?
- [gatilho 1]
- [gatilho 2]

**Principais Dores**
1. [Dor — nas palavras deles, se possível]
2. [Dor]
3. [Dor]

**Resultados Desejados**
- [Como é o sucesso para eles]
- [Como eles medem isso]
- [Como isso os faz parecer para seu chefe/equipe]

**Objeções e Medos**
- [O que os faz hesitar em comprar ou mudar]

**Alternativas que Consideram**
- [Concorrente, DIY, não fazer nada, contratar alguém]

**Vocabulário Chave**
Palavras e frases que eles realmente usam (originadas da pesquisa):
- "[frase]"
- "[frase]"

**Como Alcançá-los**
- Canais: [onde passam tempo]
- Conteúdo que consomem: [formatos, tópicos]
- Influenciadores/comunidades em que confiam: [nomes específicos, se conhecidos]

Antipadrões de Persona

  • Não as nomeie de forma fofa ("Maria do Marketing") a menos que sua equipe ache útil — geralmente é uma distração
  • Não calcule a média entre segmentos — uma persona que representa todos não representa ninguém
  • Não invente detalhes — se você não tem dados sobre algo, deixe em branco em vez de preencher
  • Revise trimestralmente — as personas se deterioram à medida que seu mercado e produto evoluem

Formatos de Entrega

Dependendo do que o usuário precisa, ofereça:

  1. Relatório de síntese de pesquisa — temas, citações, padrões e implicações
  2. Banco de citações VOC — citações literais organizadas por tema, para uso em copy
  3. Documento de persona — 1 a 3 personas construídas a partir da pesquisa
  4. Mapa de jobs-to-be-done — trabalhos funcionais, emocionais e sociais por segmento
  5. Resumo de inteligência competitiva — o que os clientes dizem sobre concorrentes vs. você
  6. Análise de lacunas de pesquisa — o que você ainda não sabe e como descobrir

Pergunte ao usuário qual(is) entrega(s) ele precisa antes de gerar a saída.


Perguntas a Fazer Antes de Prosseguir

Se o contexto não estiver claro:

  1. Qual é o objetivo? Melhorar mensagens? Construir personas? Encontrar lacunas de produto? Entender churn?
  2. O que você já tem? (transcrições, pesquisas, tickets, avaliações do G2, nada)
  3. Qual é o segmento-alvo? (todos os clientes, um nível específico, usuários que cancelaram, prospects que não compraram)
  4. Qual é o seu produto? (se não estiver no arquivo de contexto de marketing de produto)
  5. O que você quer como entrega? (relatório de síntese, persona, banco de citações, inteligência competitiva)

Não faça todas as cinco de uma vez — comece com #1 e #2, depois faça o acompanhamento conforme necessário.


Habilidades Relacionadas

Quando transferirHabilidade
Escrever copy informada pela pesquisacopywriting
Otimizar uma página usando insights de VOCcro
Construir uma página de comparação com concorrentescompetitors
Criar uma estratégia de prevenção de churn a partir de pesquisa de churnchurn-prevention
Planejar anúncios pagos informados pela pesquisaads
Escrever e-mail frio usando pesquisa de dor/gatilhocold-email
Traduzir pesquisa de clientes em um ICP para prospecçãoprospecting
Planejar conteúdo com base em tópicos descobertoscontent-strategy
Incorporar pesquisa em um plano de marketing abrangentemarketing-plan

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions

ads

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions

ai-seo

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions

analytics

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions

aso

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions

attribution

When the user wants to figure out which marketing actually drives conversions and revenue, choose or interpret an attribution model, or reconcile conflicting numbers across tools. Also use when the user mentions

churn-prevention

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions

cold-email

Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions

co-marketing

When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says

community-marketing

Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: \

competitor-profiling

When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions

competitors

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions

content-strategy

When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions

copy-editing

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions

copywriting

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says

coreyhaines31/ab-test-setup

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program," or "experiment playbook." Use this whenever someone is comparing two approaches and wants to measure which performs better, or when they want to build a systematic experimentation practice. For tracking implementation, see analytics-tracking. For page-level conversion optimization, see page-cro.

coreyhaines31/analytics-tracking

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wants to measure marketing results. For A/B test measurement, see ab-test-setup.

coreyhaines31/aso-audit

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO audit,' 'app store optimization,' 'optimize my app listing,' 'improve app visibility,' 'app store ranking,' 'audit my listing,' 'why aren't people downloading my app,' 'improve my app conversion,' 'keyword optimization for app,' or 'compare my app to competitors.' Use when the user shares an App Store or Google Play URL and wants to improve it.

coreyhaines31/competitor-alternatives

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.

coreyhaines31/email-sequence

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding-cro.

Habilidades Relacionadas