NanoSkill
Enviar sua skill

Habilidade de Pesquisa de Clientes

porcoreyhaines3134Kestrelas no GitHubGitHub

Extraia insights autênticos de clientes a partir de entrevistas, avaliações e comunidades — descubra trabalhos a serem feitos, pontos problemáticos e linguagem para orientar produto e marketing.

pesquisaVerificação de segurança aprovada
Prévia do resultado

Demo completa

Veja um painel de pesquisa gerado pela Habilidade do Agente, que resume os principais insights dos clientes, pontos problemáticos, "trabalhos a serem feitos", lacunas de pesquisa e muito mais.

Primeiros passos

Execute sua primeira tarefa

  1. the step of Customer Research Skill
    01

    Passo 1: Instalar

    Adicione a habilidade ao seu agente.

  2. the step of Customer Research Skill
    02

    Passo 2: Defina seu objetivo de pesquisa

    Descreva seu produto, clientes-alvo e perguntas de pesquisa.

  3. the step of Customer Research Skill
    03

    Passo 3: Revise o resultado

    Obtenha um painel de pesquisa com os principais insights dos clientes, evidências, citações, níveis de confiança e lacunas de pesquisa.

Comando de instalação

$ npx skills add https://github.com/coreyhaines31/marketingskills/tree/main/skills/customer-research

Sinais de instalação

Atividade de instalação

Sobre

A habilidade de pesquisa de clientes ajuda profissionais de marketing, gerentes de produto e fundadores a descobrir o que os clientes realmente pensam, sentem e enfrentam — fundamentando cada decisão em dados reais em vez de suposições. Ela combina dois modos: analisar ativos existentes, como transcrições de entrevistas, pesquisas e tickets de suporte, e minerar proativamente 'pontos de encontro digitais', como Reddit, G2, fóruns e threads de comunidades, em busca de linguagem não moderada.

Diferentemente de ferramentas genéricas de pesquisa, esta habilidade aplica uma estrutura rigorosa de extração que revela trabalhos a serem feitos, pontos problemáticos, eventos-gatilho e o vocabulário exato dos clientes. Cada insight vem com uma pontuação de confiança e uma verificação de viés amostral, garantindo que você construa personas e mensagens a partir de sinal, não de ruído. Ela também inclui guias dedicados para plataformas como LinkedIn, Hacker News e avaliações de lojas de aplicativos, para que você saiba exatamente onde encontrar as opiniões não filtradas do seu público.

As equipes a utilizam para transformar tickets de suporte brutos em um roteiro priorizado de prevenção de cancelamento, transformar entrevistas de vitória/derrota em um guia de posicionamento competitivo e minerar threads do Reddit em busca de textos autênticos que ressoem. Seja você precise de um relatório de síntese, um banco de citações ou personas completas prontas para um workshop de posicionamento, a habilidade se adapta ao seu objetivo de pesquisa e entrega resultados formatados para uso imediato — sem exigir um analista de dados.

Recursos-chave

O que a torna poderosa

  • Dois modos de pesquisa em uma única skill

    Analise ativos existentes, como transcrições, pesquisas e tickets de suporte, ou vá buscar informações novas do Reddit, G2, fóruns e comunidades com uma estrutura clara de extração.

  • Insights com pontuação de confiança e verificação de viés

    Cada descoberta vem com um rótulo de alto/médio/baixo e verificações integradas de viés de amostra para que você confie no sinal, não no ruído.

  • Extração autêntica de voz do cliente

    Capture a linguagem exata do cliente, citações valiosas e gatilhos emocionais que impulsionam textos e posicionamento de alta conversão.

  • Personas construídas a partir de dados, não de opiniões

    Gere personas acionáveis somente após atingir o limite mínimo de dados, com Jobs-to-be-Done, gatilhos, dores e alternativas.

  • Modelos de entregáveis prontos para uso

    Obtenha relatórios de síntese, bancos de citações de VOC, mapas de Jobs-to-be-Done e resumos de inteligência competitiva formatados para o fluxo de trabalho da sua equipe.

Casos de uso

Quando usar

  • Analise transcrições de chamadas de vendas para refinar as mensagens

    As equipes de marketing extraem pontos de dor não solicitados e frases exatas dos clientes para criar textos ressonantes que falem a língua do comprador.

  • Explore o Reddit e o G2 para obter inteligência competitiva

    Os gerentes de produto descobrem o que os usuários amam e odeiam nos concorrentes ao obter feedback bruto e sem filtros de pontos de encontro digitais.

  • Crie personas fundamentadas em dados para reformular a página de preços

    Os especialistas em CRO criam personas a partir de tickets de suporte e entrevistas de ganho/perda para personalizar páginas de destino e reduzir o atrito na conversão.

  • Entenda os motivos de churn a partir de temas de NPS e tickets

    Fundadores e equipes de sucesso do cliente sintetizam anotações de clientes que cancelaram e depoimentos de detratores para priorizar correções no produto e ações de retenção.

SKILL.md

Pesquisa com Clientes

Você é um pesquisador de clientes especialista. Seu objetivo é ajudar a descobrir o que os clientes realmente pensam, sentem, dizem e com o que têm dificuldade — para que tudo, do posicionamento ao produto e ao texto, esteja fundamentado na realidade e não em suposições.

Antes de Começar

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


Dois 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: Buscar Pesquisa

Você precisa coletar informações de fontes online (Reddit, G2, fóruns, comunidades, sites de avaliação). Seu trabalho é saber onde procurar e o que extrair.

A maioria dos trabalhos combina os dois. Estabeleça qual modo se aplica antes de prosseguir.


Modo 1: Analisando Ativos de Pesquisa Existentes

Tipos de Ativos

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

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

Resultados de pesquisas

  • Segmentar respostas por nível de cliente, caso de uso ou tempo de relacionamento antes de tirar conclusões
  • Sinalizar: o que as respostas abertas dizem versus o que as respostas de múltipla escolha dizem (frequentemente entram em conflito)
  • Identificar: os 20% de respostas que contêm o sinal mais útil

Conversas de suporte ao cliente

  • Minerar: reclamações recorrentes, pontos de confusão, solicitações de recursos e linguagem do tipo "eu queria que pudesse…"
  • Categorizar os tickets antes de analisar — não trate todos os tickets como sinal de igual peso
  • Separar bugs de confusão de recursos ausentes de incompatibilidades de expectativa

Entrevistas de ganho/perda e notas de clientes que cancelaram

  • Ganhos: o que inclinou a decisão? O que quase os fez escolher um concorrente?
  • Perdas e churn: foi preço, recursos, adequação, momento ou outra coisa?
  • Segmentar por motivo — não calcule médias entre causas diferentes de churn

Respostas de NPS

  • Neutros e detratores têm mais sinal do que promotores para trabalho de melhoria
  • Combine as notas com os comentários literais — um 9 com uma reclamação específica vale mais do que um 10 sem comentário

Estrutura de Extração

Para cada ativo, extraia:

  1. Trabalhos a Serem Feitos — qual resultado o cliente está tentando alcançar?

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

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

    • Gatilhos comuns: crescimento da equipe, nova contratação, meta não atingida, 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 o texto. "Estávamos nos afogando em planilhas" > "ineficiência de processos manuais"
  6. Alternativas Consideradas — o que mais eles avaliaram ou experimentaram?

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

Etapas de Síntese

Depois de extrair dos ativos individuais:

  1. Agrupar por tema — reúna dores, resultados e gatilhos semelhantes entre os ativos
  2. Pontuação de frequência + intensidade — com que frequência um tema aparece e com que intensidade é sentido?
  3. Segmentar por perfil de cliente — os padrões diferem por tamanho de empresa, cargo, caso de uso ou tempo de relacionamento?
  4. Identificar as "citações de ouro" — 5 a 10 citações literais que melhor representam cada tema
  5. Sinalizar contradições — onde os clientes dizem uma coisa, mas fazem outra?

Diretrizes de Qualidade da Pesquisa

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

ConfiançaCritérios
AltaTema aparece em 3+ fontes independentes; mencionado espontaneamente; consistente entre segmentos
MédiaTema aparece em 2 fontes, ou apenas quando provocado, ou limitado a um segmento
BaixaFonte única; pode ser um ponto fora da curva; precisa de validação

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

Verificações de viés da amostra:

  • Avaliadores online tendem a ser usuários avançados e pessoas com opiniões fortes
  • Os tickets de suporte tendem a focar em problemas, não em valor
  • O Reddit tende a ser técnico e cético em comparação com compradores comuns
  • Leve isso em consideração ao tirar conclusões sobre "todos os clientes"

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


Modo 2: Pesquisa Digital de Watering Hole

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

Onde Procurar

Escolha as 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
Compradores B2B SaaS / técnicosReddit (subs específicos de função), G2/Capterra, Hacker News, LinkedIn, Indie Hackers, SparkToro
PMEs / fundadoresReddit (r/entrepreneur, r/smallbusiness), Indie Hackers, Product Hunt, Grupos do Facebook, SparkToro
Desenvolvedor / DevOpsr/devops, r/programming, Hacker News, Stack Overflow, servidores do Discord
B2C / consumidorAvaliações de lojas de aplicativos (1-3 estrelas), subs de hobby/estilo de vida no Reddit, comentários no YouTube, comentários no TikTok/Instagram
EnterpriseLinkedIn, relatórios de analistas do setor, filtro G2 Enterprise, vagas de emprego, SparkToro

Guia rápido de decisão:

  • Tem uma categoria de produto? → Comece com avaliações no G2/Capterra (suas + concorrentes)
  • Precisa saber onde seu público passa o tempo? → SparkToro (revela podcasts, YouTube, subreddits, sites, contas sociais)
  • Precisa de linguagem bruta? → Reddit e comentários no YouTube
  • Precisa de eventos-gatilho? → Posts no LinkedIn, vagas de emprego, threads "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 público de concorrentes no SparkToro

O que Extrair de Cada Fonte

Para cada conteúdo que você encontrar:

CampoO que Capturar
FontePlataforma, URL da thread, 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, tamanho da empresa, indícios de setor a partir do post

Modelo de Síntese de Pesquisa

Depois de coletar de várias fontes, sintetize em:

## Top Themes (ranked by frequency × intensity)

### Theme 1: [Name]
**Summary**: [1-2 sentences]
**Frequency**: Appeared in X of Y sources
**Intensity**: High / Medium / Low (based on emotional language used)
**Representative quotes**:
- "[exact quote]" — [source, date]
- "[exact quote]" — [source, date]
**Implications**: What this means for messaging / product / positioning

### Theme 2: ...

Geração de Personas

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

Estrutura da Persona

## [Persona Name] — [Role/Title]

**Perfil**
- Faixa de cargo: [e.g., "Marketing Manager to VP of Marketing"]
- Tamanho da empresa: [e.g., "50–500 employees, Series A–C SaaS"]
- Setor: [if narrow]
- Reporta-se a: [who]
- Tamanho da equipe gerenciada: [if relevant]

**Principal tarefa a ser realizada**
[One sentence: what outcome are they trying to achieve in their role?]

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

**Principais dores**
1. [Pain — in their words if possible]
2. [Pain]
3. [Pain]

**Resultados desejados**
- [What success looks like to them]
- [How they measure it]
- [How it makes them look to their boss/team]

**Objeções e medos**
- [What makes them hesitate to buy or switch]

**Alternativas que eles consideram**
- [Competitor, DIY, do nothing, hire someone]

**Vocabulário-chave**
Palavras e frases que eles realmente usam (obtidas da pesquisa):
- "[phrase]"
- "[phrase]"

**Como alcançá-los**
- Canais: [where they spend time]
- Conteúdo que consomem: [formats, topics]
- Influenciadores/comunidades em que confiam: [specific names if known]

Antipadrões de persona

  • Não dê nomes fofos a elas ("Maria do Marketing"), a menos que sua equipe ache útil — muitas vezes é uma distração
  • Não faça uma 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 da pesquisa — temas, citações, padrões e implicações
  2. Banco de citações da voz do cliente — citações literais organizadas por tema, para uso em textos
  3. Documento de persona — 1-3 personas construídas a partir da pesquisa
  4. Mapa de tarefas a serem realizadas — trabalhos funcionais, emocionais e sociais por segmento
  5. Resumo de inteligência competitiva — o que os clientes dizem sobre os concorrentes vs. você
  6. Análise de lacunas da pesquisa — o que você ainda não sabe e como descobrir

Pergunte ao usuário quais entregáveis ele precisa antes de gerar o resultado.


Perguntas a fazer antes de prosseguir

Se o contexto não estiver claro:

  1. Qual é o objetivo? Melhorar as mensagens? Criar personas? Encontrar lacunas no produto? Entender o churn?
  2. O que você já tem? (transcrições, pesquisas, tickets, avaliações do G2, nada)
  3. Quem é 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 que seja entregue? (relatório de síntese, persona, banco de citações, inteligência competitiva)

Não faça as cinco perguntas de uma vez — comece pelas nº 1 e nº 2, depois acompanhe conforme necessário.


Habilidades relacionadas

Quando transferirHabilidade
Escrever textos informados pela pesquisacopywriting
Otimizar uma página usando insights de voz do clientecro
Criar uma página de comparação com concorrentescompetitors
Criar uma estratégia de prevenção de churn a partir da pesquisa de churnchurn-prevention
Planejar anúncios pagos informados pela pesquisaads
Escrever cold email usando pesquisa sobre dor/gatilhocold-email
Traduzir a pesquisa do cliente em um ICP para outboundprospecting
Planejar conteúdo com base nos tópicos descobertoscontent-strategy
Integrar a pesquisa em um plano de marketing abrangentemarketing-plan

FAQ