onboarding-cro

Visão geral da skill onboarding-cro

Para que serve onboarding-cro

A skill onboarding-cro ajuda a melhorar o onboarding pós-cadastro, a ativação e o tempo até o primeiro valor percebido. Ela funciona melhor quando os usuários criam conta, mas não chegam ao primeiro resultado relevante que comprova o valor do seu produto.

Quem deve instalar onboarding-cro

Essa skill é indicada para profissionais de product marketing, times de growth, founders, PMs e UX writers que trabalham com fluxos de SaaS ou product-led growth. Ela é especialmente útil quando o principal problema não é aquisição, e sim uma ativação fraca depois do signup.

O trabalho real que a skill resolve

Use onboarding-cro quando você precisa de algo além de conselhos genéricos de “melhorar o onboarding”. A skill direciona a análise para um evento claro de ativação, diagnóstico de fricção, aceleração do primeiro valor, desenho de checklist de onboarding, uso de empty states e experimentos testáveis.

O que diferencia esta skill

Em comparação com um prompt comum, a onboarding-cro skill opera com um escopo mais bem definido:

• começa pelo contexto do produto e da ativação
• foca no aha moment, não em opiniões amplas de UX
• transforma onboarding em experimentos mensuráveis
• inclui padrões específicos destacados no repositório, como desenho de checklist, uso de empty states e redução do tempo até valor

Casos ideais e casos em que não encaixa

Melhor cenário de uso:

• usuários de trial se cadastram, mas não concluem a configuração
• novos usuários não chegam ao primeiro marco de sucesso
• você precisa de experimentos de onboarding ligados a métricas de ativação

Não é a melhor opção quando:

• você está otimizando apenas a conversão antes do signup
• sua principal necessidade é estratégia de emails de lifecycle
• o problema está em retenção muito além da experiência inicial

Nesses casos, o próprio repositório aponta skills relacionadas, como signup-flow-cro ou email-sequence.

Como usar a skill onboarding-cro

Contexto de instalação do onboarding-cro

Instale a partir do repositório pai, já que onboarding-cro fica em skills/onboarding-cro dentro de coreyhaines31/marketingskills:

npx skills add https://github.com/coreyhaines31/marketingskills --skill onboarding-cro

Se o seu ambiente usa outro carregador de skills, o ponto importante é a URL do repositório e o slug exato da skill: onboarding-cro.

Leia estes arquivos primeiro

Para decidir rápido, examine:

• skills/onboarding-cro/SKILL.md
• skills/onboarding-cro/evals/evals.json
• skills/onboarding-cro/references/experiments.md

Por que essa ordem importa:

• SKILL.md mostra o método de operação
• evals/evals.json mostra o que uma boa saída deve conter
• references/experiments.md oferece um bom conjunto de ideias de teste depois que o diagnóstico estiver feito

Quais inputs a skill precisa

A qualidade do onboarding-cro usage depende fortemente de quatro inputs:

1. tipo de produto e público
2. sua definição de ativação ou aha moment
3. etapas atuais do onboarding
4. pontos conhecidos de drop-off ou métricas de base

Se você omitir isso, o modelo ainda vai responder, mas a saída tende a ficar genérica e menos testável.

Valide primeiro o contexto de product marketing

O repositório instrui explicitamente o agente a ler .agents/product-marketing-context.md primeiro, ou .claude/product-marketing-context.md em setups mais antigos. Se o seu workspace tiver um desses arquivos, forneça-o ou garanta que o agente consiga acessá-lo antes de pedir recomendações.

Isso importa porque recomendações de onboarding costumam falhar quando estão desconectadas do posicionamento do produto, do público e da proposta de valor.

Transforme um pedido vago em um prompt forte

Prompt fraco:
“Help me improve onboarding.”

Prompt forte:
“We run a B2B project management tool for agencies. Our activation event is ‘create first project and invite one teammate.’ Only 30% of trial users create a project in week one. Current flow after signup: email verify, workspace setup, template choice, project creation, invite step. Biggest drop-off is after workspace setup. Use onboarding-cro to diagnose friction, redesign the first-run path, suggest a 3-7 item checklist, improve empty states, and propose experiments with metrics.”

Esse prompt dá estrutura suficiente para a skill produzir um plano de ação, em vez de sugestões amplas demais.

O que bons prompts de onboarding-cro costumam incluir

Inclua o máximo possível destes elementos:

• definição do evento de ativação
• etapas do fluxo atual de onboarding
• contexto mobile ou desktop
• onboarding self-serve ou assistido por vendas
• diferenças entre segmentos de usuários
• baseline de analytics
• screenshots ou texto copiado da UI
• restrições como limites de engenharia ou exigências legais

A skill fica muito mais forte quando consegue separar etapas críticas de configurações apenas desejáveis.

Workflow recomendado na prática com onboarding-cro

Um onboarding-cro guide prático costuma seguir esta sequência:

1. definir o evento de ativação
2. mapear o caminho atual do signup até o primeiro valor
3. identificar fricções evitáveis e etapas desnecessárias
4. decidir entre onboarding product-first, guiado ou value-first
5. desenhar um checklist curto com ações de conclusão claras
6. melhorar empty states e momentos em que o usuário trava
7. buscar ideias de experimentos em references/experiments.md
8. vincular métricas de sucesso antes de publicar as mudanças

Essa sequência acompanha a ênfase central do repositório em tempo até valor e um objetivo por sessão.

Como usar bem o padrão de checklist

Os evals sugerem com força um padrão de checklist com algo em torno de 3 a 7 itens. Essa é uma restrição útil, não só uma preferência de formatação. Se o checklist for mais longo, os usuários passam a sentir a configuração como trabalho; se for mais curto, ele pode não gerar tração suficiente.

Bons itens de checklist são:

• observáveis
• ligados ao valor do produto
• organizados em sequência até o aha moment
• concluíveis em uma única sessão

Itens ruins de checklist são tarefas administrativas sem retorno visível para o usuário.

Use empty states como superfícies de onboarding

Uma das partes mais úteis de onboarding-cro for Conversion é a forma como trata empty states. Se um usuário cai em um dashboard vazio, uma lista de projetos vazia ou um workspace vazio, essa tela deve conduzir ativamente para a próxima melhor ação:

• explicar o valor daquela tela
• mostrar um CTA principal
• reduzir a carga de decisão
• oferecer templates, exemplos ou dados fictícios, quando fizer sentido

Muitas vezes isso traz resultado mais rápido do que redesenhar todo o fluxo de signup.

Puxe ideias de experimento do arquivo de referência

Vale a pena ler references/experiments.md porque ele transforma estratégia em candidatos concretos de teste. Entre as categorias úteis estão:

• redução de fricção
• mudança na ordem das etapas
• teste de caminhos value-first
• uso de templates pré-preenchidos
• ajuste entre etapas obrigatórias e opcionais
• recuperação de usuários que travaram
• melhorias de performance, acessibilidade e onboarding mobile

Use esse arquivo depois do diagnóstico, não antes. Caso contrário, você corre o risco de gerar listas aleatórias de experimentos sem ligação com o gargalo real.

Métricas que você deve pedir sempre

Não use onboarding-cro sem uma camada de mensuração. Peça:

• taxa de ativação
• tempo até ativação
• taxa de conclusão por etapa
• taxa de conclusão do checklist
• drop-off por etapa
• diferenças de coorte por segmento ou fonte de aquisição

Essa skill se torna muito mais valiosa quando cada recomendação está conectada a uma mudança mensurável.

FAQ da skill onboarding-cro

onboarding-cro é só para produtos SaaS?

Não. A onboarding-cro skill é mais obviamente útil para SaaS, mas também pode ajudar qualquer produto que tenha uma jornada inicial de uso com significado: marketplaces, apps de fintech, ferramentas de colaboração, creator tools ou produtos de AI. O requisito central é ter um evento de ativação definível.

Isso é melhor do que um prompt comum de CRO?

Na maioria dos casos, sim, se o seu problema for ativação e não uma crítica geral de UX. A skill oferece um enquadramento mais disciplinado: definir o aha moment, reduzir o tempo até valor, focar cada sessão em um objetivo, melhorar o desenho do checklist e gerar experimentos ligados a métricas.

Quando eu não devo usar onboarding-cro?

Não use onboarding-cro install como primeiro passo se o problema estiver claramente antes do signup. Se os usuários nem começam o registro, outra skill de conversão será mais adequada. Também não é a ferramenta certa para programas de retenção de longo prazo ou estratégia puramente de nutrição por email.

onboarding-cro é amigável para iniciantes?

Sim, desde que você consiga descrever seu produto, seus usuários e o fluxo atual. Você não precisa ter expertise profunda em CRO, mas iniciantes costumam obter resultados melhores quando trazem screenshots, métricas de funil e uma definição explícita de ativação, em vez de fazer pedidos abstratos.

O repositório inclui código de implementação?

Não há automação relevante nem scripts em destaque aqui. Esta é uma skill de raciocínio e workflow, apoiada principalmente por SKILL.md, evals e uma referência de experimentos. Instale pela melhora na qualidade da análise e das recomendações, não esperando código plug-and-play.

Como saber se a skill está funcionando bem?

Compare a saída com as expectativas no estilo dos evals em evals/evals.json. Uma resposta forte deve:

• verificar o contexto de product marketing
• definir claramente a ativação
• diagnosticar a fricção no tempo até valor
• recomendar uma abordagem de onboarding
• sugerir um checklist enxuto
• usar empty states de forma intencional
• propor experimentos
• incluir mensuração

Como melhorar a skill onboarding-cro

Dê ao onboarding-cro uma meta de ativação precisa

O maior ganho isolado é dizer exatamente qual ação do usuário significa “este usuário percebeu valor”. Exemplos:

• “imports first CSV and sees a live dashboard”
• “creates first project and invites one teammate”
• “uploads first design and receives one comment”

Sem isso, a skill não consegue priorizar corretamente as etapas.

Forneça o fluxo atual como uma sequência numerada

Não diga apenas “nosso onboarding é truncado”. Liste as etapas na ordem:

1. signup
2. email verification
3. workspace naming
4. template selection
5. data import
6. dashboard view

Isso ajuda a skill a identificar onde o valor está demorando a aparecer e quais etapas podem ser adiadas, removidas ou consolidadas.

Compartilhe fricção real, não suposições

Inputs fortes incluem:

• “60% drop after email verification”
• “mobile users abandon template selection”
• “trial users skip integrations and never return”

Inputs fracos soam como opinião:

• “users seem confused”
• “the flow feels long”

A skill melhora quando você fornece comportamento observado.

Peça um redesenho e mais três experimentos

Uma boa forma de melhorar o onboarding-cro usage é estruturar o pedido de saída assim:

• um caminho principal de onboarding recomendado
• três experimentos para testar contra ele
• impacto esperado e tradeoffs
• métricas para cada um

Isso mantém a resposta prática, em vez de dispersa.

Force priorização por meio de restrições

Se houver limites reais, diga claramente:

• no major backend work this quarter
• mobile only
• cannot remove compliance steps
• design team unavailable
• can only ship copy and ordering changes

Prompts sensíveis a restrições produzem recomendações mais afiadas e reduzem conselhos irreais.

Falha comum do onboarding-cro: otimizar setup em vez de valor

Times frequentemente pedem à skill para otimizar a conclusão de etapas internas de setup, e não o valor para o usuário. Um fluxo de configuração mais curto não basta se as pessoas continuam sem experimentar o benefício principal. Diga à skill para otimizar o primeiro valor, não apenas o preenchimento de formulários.

Falha comum do onboarding-cro: objetivos demais na mesma sessão

O material de origem enfatiza um objetivo por sessão. Se o seu onboarding tenta ensinar todos os recursos de uma vez, peça à skill para separar:

• ações obrigatórias para ativação
• configuração secundária
• educação posterior

Isso normalmente melhora a conclusão e a clareza.

Melhore as saídas com artefatos

Se possível, anexe:

• screenshots das telas de first-run
• textos de modais e tooltips
• screenshots de analytics
• nomes de eventos do seu product analytics
• trechos de entrevistas com usuários recém-cadastrados

Esses artefatos permitem que onboarding-cro critique momentos concretos em vez de inventá-los.

Itere depois da primeira resposta

Depois da primeira rodada, faça perguntas de continuação como:

• “Rewrite the checklist for enterprise admins”
• “Now optimize for mobile users”
• “Keep email verification but move it later”
• “Rank these experiments by ease and likely impact”
• “Turn this into an A/B test plan”

É nessa segunda iteração que o onboarding-cro guide frequentemente passa a ficar realmente pronto para implementação.

Use a referência de experimentos de forma seletiva

Não despeje toda a lista de references/experiments.md no seu roadmap. Para aumentar a utilidade da skill, peça que ela filtre os experimentos pelo seu gargalo exato, como:

• reducing friction before first project creation
• improving empty-state conversion
• recovering users who stalled after signup day one

O uso seletivo gera um programa de testes mais enxuto e aumenta as chances de lift mensurável.