customer-persona

Visão geral

O que a skill customer-persona faz

A skill customer-persona ajuda você a transformar pesquisa de mercado em personas de clientes claras e estruturadas. Ela usa o CLI do inference.sh para:

• Pesquisar seu mercado-alvo com busca na web auxiliada por IA
• Capturar dados demográficos, psicográficos e jobs-to-be-done
• Mapear jornadas de clientes e pontos de contato principais
• Definir antipersonas para que o time saiba quem não deve ser o foco
• Gerar imagens realistas de avatar de persona para apresentações, briefs e documentos

O resultado é pensado para estratégia de marketing, pesquisa de UX, discovery de produto, capacitação de vendas e planejamento de conteúdo. Em vez de juntar manualmente dados de pesquisas, conteúdo da web e anotações, customer-persona oferece um fluxo de trabalho repetível, com apoio de IA.

Para quem é o customer-persona

Use esta skill se você é:

• Pesquisador(a) de UX e gerente de produto – para validar para quem você está construindo e documentar JTBD, dores e jornadas
• Equipe de marketing, growth e conteúdo – para alinhar campanhas, mensagens e calendários editoriais em torno de um perfil de cliente ideal compartilhado
• Vendas e customer success – para brifar o time com personas objetivas que destacam gatilhos, objeções e canais preferidos
• Fundadores e times em estágio inicial – para rapidamente formular e refinar uma hipótese de público-alvo antes de pesquisas quantitativas profundas

Quais problemas ela resolve

customer-persona é uma boa opção quando você precisa:

• Substituir descrições vagas de “usuário-alvo” por personas detalhadas e fáceis de compartilhar
• Sustentar suposições de personas com pesquisa de mercado e de audiência recentes
• Visualizar personas com fotos de avatar para apresentações e documentação
• Capturar jobs-to-be-done, motivações, barreiras e cenários-chave em um template consistente
• Identificar antipersonas para evitar desperdício de verba e funcionalidades desalinhadas

Ela não é uma plataforma completa de pesquisa ou uma ferramenta de analytics. Em vez disso, se apoia nas suas entradas de pesquisa e em dados online para ajudar você a sintetizar e apresentar o entendimento do cliente de forma estruturada.

Quando esta skill pode não ser ideal

customer-persona pode não ser a melhor escolha se:

• Você precisa de segmentação estatisticamente rigorosa a partir de grandes bases de dados proprietárias
• Sua organização proíbe o uso de pesquisa na web com apoio de IA para trabalho de personas
• Você quer uma interface visual de arrastar e soltar, em vez de um fluxo de trabalho baseado em CLI e texto

Se você está confortável em rodar comandos com o CLI do inference.sh e trabalhar com templates nos seus próprios documentos, esta skill tende a encaixar bem.

Como usar

Pré-requisitos e instalação

customer-persona roda via inference.sh CLI (infsh).

1. Instale o inference.sh CLI
   Siga as instruções oficiais de instalação no repositório:
   https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

2. Autentique-se com sua conta inference.sh:

   infsh login
   

3. Adicione a skill ao seu ambiente de skills (Agent Skills Finder ou similar):

   npx skills add https://github.com/inferen-sh/skills --skill customer-persona
   

Depois de instalada, você pode explorar o guia e os templates no caminho guides/product/customer-persona do repositório para uma referência mais detalhada.

Etapa 1 – Pesquise seu mercado-alvo

Use o CLI do inference.sh para reunir insights atualizados sobre sua audiência. O guia de quick start da skill sugere usar tavily/search-assistant para fazer pesquisa na web:

infsh app run tavily/search-assistant --input '{
  "query": "SaaS product manager demographics pain points 2024 survey"
}'

Adapte o query ao seu público-alvo, por exemplo:

• "B2B finance directors challenges choosing accounting software"
• "Gen Z social media usage habits 2024 report"
• "Healthcare IT manager buying criteria for security tools"

Salve os achados mais úteis nas suas próprias anotações ou em um documento de pesquisa. Esses insights vão alimentar os dados demográficos, psicográficos e jobs-to-be-done da sua persona.

Etapa 2 – Gere uma imagem de avatar da persona

Para tornar as personas mais memoráveis em apresentações e briefs, customer-persona orienta você a gerar um avatar realista com um modelo de imagem compatível, como falai/flux-dev-lora via inference.sh:

infsh app run falai/flux-dev-lora --input '{
  "prompt": "professional headshot photograph of a 35-year-old woman, product manager, friendly confident expression, modern office background, natural lighting, business casual attire, realistic portrait",
  "width": 1024,
  "height": 1024
}'

Personalize o prompt para combinar com a sua persona em termos de:

• Faixa etária e cargo (por exemplo, "VP of Marketing", "Customer Support Lead")
• Estilo (por exemplo, mais formal ou mais casual)
• Contexto (por exemplo, "remote home office", "hospital environment", "warehouse setting")

Exporte e armazene a imagem resultante onde o seu time guarda documentos de persona (por exemplo, Notion, Confluence ou seu design system).

Etapa 3 – Preencha o template de persona

O repositório fornece um Persona Template que cobre as seções centrais de uma persona. Embora o texto completo do template esteja no repositório, ele é estruturado em torno de elementos como:

• Nome da persona e resumo principal (headline)
• Espaço para a foto do avatar
• Perfil demográfico
• Perfil psicográfico (motivações, valores, atitudes)
• Jobs-to-be-done e cenários-chave
• Dores, barreiras e gatilhos
• Canais preferidos e processo de decisão

Use os resultados da sua pesquisa e o conhecimento interno (entrevistas com clientes, tickets de suporte, análises de win/loss) para preencher cada seção do template. Você pode copiar o template para o seu formato preferido (Markdown, Google Docs, Notion etc.).

Etapa 4 – Registre a jornada e as antipersonas

customer-persona incentiva você a ir além de um perfil estático:

• Mapeamento de jornada – Documente as principais etapas (awareness, consideration, trial, purchase, onboarding, renewal) e o que sua persona está pensando e fazendo em cada uma delas.
• Antipersonas – Identifique perfis que não devem ser priorizados. Por exemplo, usuários que parecem semelhantes à primeira vista, mas diferem em orçamento, autoridade ou caso de uso.

Isso transforma as personas de um simples slide em uma ferramenta prática para fluxos de UX, planejamento de conteúdo e playbooks de vendas.

Etapa 5 – Integre às suas rotinas de trabalho

Embora customer-persona em si se concentre em pesquisa e estrutura, você pode conectar os resultados a:

• Pesquisa de UX – Para priorizar quais cenários testar e quais tipos de usuários recrutar
• Roadmaps de produto – Para justificar funcionalidades e trade-offs com base em personas
• Marketing de conteúdo – Para escrever campanhas, landing pages e conteúdo social direcionado a personas específicas
• Customer success – Para adaptar onboarding, FAQs e playbooks de renovação

Use os artefatos de persona como referência compartilhada em documentos de planejamento, rituais e fóruns de decisão.

Arquivos e referências para revisar

Após a instalação, revise estes arquivos no repositório inferen-sh/skills para uma visão mais completa:

• SKILL.md – Descrição geral da skill e ferramentas permitidas
• guides/product/customer-persona – Guia detalhado, templates e exemplos para criação de personas (quando disponíveis)

Esses recursos ampliam o quick start e mostram como adaptar o fluxo de trabalho à sua organização.

FAQ

Para que serve a skill customer-persona?

customer-persona é usada para criar personas de clientes baseadas em pesquisa e artefatos relacionados (mapas de jornada, antipersonas e imagens de avatar) usando o CLI do inference.sh. Ela é especialmente útil quando você precisa de documentação de personas clara e compartilhável para marketing, pesquisa de UX, estratégia de produto e capacitação de vendas.

Como instalo o customer-persona?

1. Instale o inference.sh CLI seguindo as instruções em:
   https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

2. Faça login com:

   infsh login
   

3. Adicione a skill ao seu ambiente de skills:

   npx skills add https://github.com/inferen-sh/skills --skill customer-persona
   

Depois de instalar, abra SKILL.md e o diretório guides/product/customer-persona no repositório para acessar o guia completo e o template.

Preciso saber programar para usar o customer-persona?

Você não precisa escrever código de aplicação, mas precisa estar à vontade para rodar comandos básicos de CLI. O fluxo de trabalho é guiado pelo inference.sh CLI (infsh) e pelos exemplos de comandos fornecidos na documentação da skill.

Posso usar meus próprios dados de pesquisa com esta skill?

Sim. customer-persona foi projetada para combinar suas pesquisas existentes (entrevistas, surveys, analytics, registros de suporte) com busca de mercado baseada em IA via inference.sh. Use seus dados como fonte principal de verdade e aplique a estrutura e os comandos recomendados para preencher lacunas e formatar as personas finais.

Como funciona a geração das imagens de avatar?

O quick start da skill demonstra como gerar um avatar de persona usando um modelo como falai/flux-dev-lora via inference.sh:

infsh app run falai/flux-dev-lora --input '{
  "prompt": "professional headshot photograph of a 35-year-old woman, product manager, friendly confident expression, modern office background, natural lighting, business casual attire, realistic portrait",
  "width": 1024,
  "height": 1024
}'

Você pode ajustar o prompt para que o avatar corresponda à descrição da sua persona. A skill não hospeda as imagens; você as armazena e reutiliza nas suas próprias ferramentas.

customer-persona é adequado para redes sociais e planejamento de conteúdo?

Sim. Um dos principais usos do customer-persona é ajudar times de conteúdo e social media a entender com quem estão falando. As personas destacam tópicos-chave, objeções e canais, que podem ser traduzidos diretamente em calendários de conteúdo, briefs de campanha e mensagens para redes sociais.

customer-persona substitui entrevistas com usuários ou ferramentas de analytics?

Não. customer-persona não coleta dados brutos. Ela parte do princípio de que você já tem pesquisa existente ou quer começar com pesquisa na web apoiada por IA. A skill ajuda você a sintetizar e estruturar os insights; ela não substitui conversar com usuários ou rodar análises.

Onde posso ver o fluxo completo e os templates?

Abra o repositório inferen-sh/skills e navegue até:

• SKILL.md – para entender o escopo da skill customer-persona
• guides/product/customer-persona – para o template detalhado de persona, estrutura de exemplo e passo a passo

Use esses materiais como ponto de partida e adapte textos, seções e prompts para os fluxos de trabalho e padrões de pesquisa da sua empresa.