onboarding-cro

Visão geral

O que é onboarding-cro?

A skill onboarding-cro é um sistema especialista focado em onboarding pós-cadastro e ativação de usuários. Ela foi criada para ajudar você a melhorar a primeira experiência com o produto, reduzir o time-to-value e levar mais novos usuários ao “momento aha” e ao hábito central de uso.

Em vez de conselhos genéricos de UX, onboarding-cro orienta você em:

• Entender o contexto do seu produto e a definição de ativação
• Auditar o que acontece depois do cadastro
• Identificar fricções em fluxos de onboarding e em empty states
• Desenhar checklists e fluxos que levem o usuário rapidamente ao valor
• Planejar experimentos e métricas para melhorar a ativação de forma contínua

Essa skill fica na interseção de otimização de landing page, wikis de onboarding e auditorias de UX. Ela é especialmente útil quando você já gera cadastros, mas poucos novos usuários concluem a configuração ou se tornam ativos.

Para quem é onboarding-cro?

Use onboarding-cro se você é:

• Um(a) growth ou product marketer responsável por ativação de free trial ou freemium
• Um(a) product manager ou UX designer melhorando a experiência da primeira sessão
• Um(a) founder ou construtor(a) solo tentando transformar cadastros em usuários retidos
• Um(a) desenvolvedor(a) integrando um playbook de CRO reutilizável em um agente de IA ou ferramenta interna

É uma boa opção para produtos SaaS, product-led growth, B2B e B2C em que a ativação está claramente ligada a um conjunto pequeno de ações-chave (por exemplo, criar o primeiro projeto, convidar um integrante do time, fazer upload de um arquivo).

Problemas que esta skill ajuda a resolver

Instale e use onboarding-cro quando você estiver enfrentando questões como:

• Usuários se cadastram mas nunca concluem o onboarding
• Baixa taxa de ativação (poucos usuários chegam ao momento aha)
• Time-to-value lento (valor central escondido atrás de etapas demais)
• Primeira experiência de uso confusa e empty states pouco orientadores
• Ausência de um onboarding checklist ou caminho claro de sucesso
• Falta de experimentos e métricas estruturados para CRO de onboarding

Se você precisa otimizar o próprio formulário de cadastro/registro, use a skill signup-flow-cro. Para campanhas de lifecycle e nutrição após o onboarding, veja a skill email-sequence.

Quando onboarding-cro não é uma boa escolha

Esta skill não é indicada para:

• Aquisição de tráfego topo de funil ou otimização de campanhas de mídia
• Experimentos em página de preços sem relação com onboarding
• Campanhas de engajamento de longo prazo além das primeiras sessões
• Implementações técnicas profundas de analytics (configuração de ferramentas de tracking, desenho de schema)

Ainda assim, você pode usar a estrutura de experimentos e métricas como insumo para um fluxo separado de analytics ou de ferramentas de email.

Como usar

Instalação

Para adicionar onboarding-cro ao ambiente do seu agente, instale a partir do repositório marketingskills:

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

Após a instalação:

1. Abra skills/onboarding-cro/SKILL.md para entender o comportamento da skill e suas premissas.
2. Revise os materiais de apoio em:
   • evals/evals.json – prompts de exemplo, raciocínios esperados e assertions
   • references/experiments.md – ideias detalhadas de experimentos de onboarding e métricas

Integre a skill ao seu agente ou fluxo de trabalho de acordo com a forma como sua plataforma carrega skills a partir de SKILL.md e das pastas associadas.

Fluxo principal: do contexto aos experimentos

A skill onboarding-cro segue um fluxo estruturado antes de recomendar mudanças:

1. Carregar o contexto de product marketing

Se o seu repositório inclui um documento de contexto de product marketing, onboarding-cro foi desenhada para usá-lo primeiro:

• Procura .agents/product-marketing-context.md (ou .claude/product-marketing-context.md em setups mais antigos)
• Lê esse arquivo para evitar repetir perguntas já respondidas

Se você não tiver esse arquivo, considere criá-lo. Inclua:

• Tipo de produto (B2B/B2C, SaaS, mobile etc.)
• Público-alvo e proposta de valor central
• Modelo de precificação e principais casos de uso

2. Definir ativação e o momento aha

Em seguida, a skill orienta você a definir o que significa ativação bem-sucedida no seu produto, por exemplo:

• Ferramentas de projeto: create first project
• Ferramentas de design: upload a design, invite a teammate, leave a comment
• Ferramentas de colaboração: create workspace, invite team, send first message

Uma definição clara de ativação permite que a skill:

• Foque o fluxo de onboarding em um conjunto pequeno de ações-chave
• Avalie se o time-to-value é aceitável
• Sugira um checklist com 3 a 7 etapas concretas que se alinhem à ativação

3. Auditar o fluxo atual pós-cadastro

Onboarding-cro ajuda você a mapear o que acontece imediatamente após o cadastro:

• Em qual página ou tela o usuário aterrissa
• Se ele vê uma UI focada no produto, um guided setup ou um tour orientado a valor
• Onde ocorrem os drop-offs antes das ações de ativação

Resultados comuns da auditoria incluem:

• Um funil simplificado, etapa a etapa, do cadastro até a ativação
• Identificação de etapas de alta fricção e momentos confusos
• Revisão de empty states (por exemplo, dashboards de projeto em branco, inbox vazia) como oportunidades de orientação

4. Escolher um padrão de fluxo de onboarding

Com base no seu contexto, a skill recomenda uma abordagem como:

• Product-first: mostrar a UI principal imediatamente com boas pistas in-product
• Guided setup: um wizard ou checklist estruturado para configurar o essencial
• Value-first: começar com um exemplo pré-preenchido ou dados de demo para o usuário ver valor antes de fazer trabalho

Essa escolha é informada pelos padrões de avaliação em evals/evals.json, que enfatizam:

• Avaliação de time-to-value
• Padrões de checklist (3–7 itens)
• Tratamento de empty states como superfícies de orientação

5. Desenhar um onboarding checklist focado

A partir das diretrizes do repositório, a skill incentiva um checklist enxuto para direcionar a ativação. Por exemplo, uma ferramenta de colaboração em design pode usar:

1. Upload your first design
2. Invite at least one teammate
3. Leave or receive a comment

O padrão de checklist garante:

• No máximo 3 a 7 etapas
• Cada etapa claramente ligada à ativação ou a uma configuração crítica
• Tarefas opcionais não bloqueiam as ações que levam ao momento aha

6. Usar experimentos de references/experiments.md

O arquivo references/experiments.md traz uma biblioteca abrangente de ideias de experimentos de onboarding, incluindo:

• Flow simplification experiments – quantidade de etapas obrigatórias, campos opcionais vs. obrigatórios, opções de pular etapas
• Guided experience experiments – product tours, clareza de CTAs, orientação dentro da UI
• Personalization experiments – personalização do onboarding por segmento ou job-to-be-done
• Quick wins & engagement experiments – time-to-value mais rápido, mecânicas de motivação, prompts de suporte
• Email & multi-channel experiments – fluxos de onboarding por email e multicanal, conectados ao comportamento no produto
• Re-engagement experiments – trazer de volta usuários que travaram para concluírem a configuração
• Technical & UX experiments – performance, onboarding em mobile, acessibilidade

Onboarding-cro se apoia nessas ideias para recomendar:

• Testes A/B específicos
• Hipóteses ligadas a pontos de fricção
• Priorização focada em time-to-value e ativação

7. Definir métricas e mensuração

A especificação de eval em evals/evals.json espera que a skill traga métricas para cada recomendação, geralmente incluindo:

• Taxa de ativação (porcentagem de novos cadastros que concluem as ações de ativação definidas)
• Time-to-value (tempo do cadastro até a ativação)
• Taxas de conclusão e drop-off por etapa
• Taxa de conclusão do checklist

Você pode plugar essas métricas em suas ferramentas de analytics ou BI; onboarding-cro ajuda a especificar o que acompanhar e por quê.

Dicas práticas de configuração

• Mantenha o arquivo de contexto do produto atualizado: Sempre que seu ICP, proposta de valor ou precificação mudarem, atualize .agents/product-marketing-context.md para que as recomendações de onboarding continuem alinhadas.
• Comece com uma definição principal de ativação: Evite múltiplas definições concorrentes em um mesmo ciclo de experimentos.
• Limite o escopo por segmento: Se você atende a vários tipos de usuário, rode onboarding-cro para um segmento principal de cada vez.
• Combine com signup-flow-cro: Primeiro corrija as grandes fricções no cadastro; depois use onboarding-cro para otimizar o que acontece logo em seguida.

FAQ

O que onboarding-cro faz na prática depois de instalado?

Onboarding-cro atua como um estrategista de onboarding estruturado dentro do seu ecossistema de agentes. Ela:

• Lê o contexto de product marketing quando disponível
• Faz perguntas direcionadas sobre seu fluxo de onboarding e definição de ativação
• Audita o caminho atual pós-cadastro e os empty states
• Propõe uma abordagem de onboarding (product-first, guided setup ou value-first)
• Constrói um checklist conciso e focado em ativação
• Sugere experimentos e métricas com base em references/experiments.md e evals/evals.json

Em que onboarding-cro é diferente de signup-flow-cro?

• signup-flow-cro é focada no funil de registro: campos do formulário, número de etapas, conversão de visitante para conta criada.
• onboarding-cro começa depois do cadastro e foca na ativação: primeira experiência de uso, checklists, empty states, time-to-value e retenção inicial.

Use as duas em conjunto se você precisa de otimização ponta a ponta — da landing page até o usuário ativado.

Eu preciso de um arquivo de contexto de product marketing para onboarding-cro funcionar?

Não, mas ela funciona melhor com esse arquivo. A skill foi desenhada para procurar por:

• .agents/product-marketing-context.md
• Ou .claude/product-marketing-context.md em setups mais antigos

Se o arquivo existir, onboarding-cro vai se apoiar nele e só pedir detalhes faltantes e específicos da tarefa. Sem esse arquivo, você terá que responder mais perguntas de contexto manualmente.

Onboarding-cro consegue lidar com diferentes tipos de produto (B2B vs. B2C, SaaS vs. mobile)?

Sim. Os padrões centrais em SKILL.md, evals/evals.json e references/experiments.md são agnósticos ao tipo de produto. A skill pergunta explicitamente sobre:

• Tipo de produto (B2B/B2C)
• Proposta de valor central
• Principais ações de ativação

Isso permite adaptar a auditoria e as sugestões de experimentos aos desafios específicos de onboarding e ativação do seu produto.

Que tipo de experimentos posso esperar de onboarding-cro?

Com base em references/experiments.md, você pode esperar recomendações como:

• Alterar empty states para mostrar templates ou dados de exemplo
• Ajustar a ordem das etapas para trazer ações de alto valor mais cedo
• Reduzir campos obrigatórios ou etapas na configuração inicial
• Adicionar ou refinar checklists de onboarding com indicadores de progresso
• Testar product tours versus orientações leves dentro da UI
• Disparar nudges de re-engajamento para usuários que travam antes da ativação

Cada experimento vem acompanhado de uma hipótese clara e resultados mensuráveis.

Como saber se onboarding-cro está funcionando?

Acompanhe as métricas sugeridas pela skill, normalmente:

• Aumento na taxa de ativação em um período definido
• Redução da mediana de time-to-value
• Maiores taxas de conclusão dos checklists de onboarding
• Melhor engajamento nas primeiras sessões

Rode experimentos de preferência um por vez, atribua mudanças a iterações específicas e use onboarding-cro para refinar o próximo ciclo de testes.

Desenvolvedores podem estender ou adaptar onboarding-cro?

Sim. Como onboarding-cro é definida em SKILL.md com arquivos de suporte como evals/evals.json e references/experiments.md, desenvolvedores podem:

• Fazer fork do repositório coreyhaines31/marketingskills
• Ajustar prompts de avaliação e assertions para refletir seus frameworks internos
• Adicionar listas de experimentos ou métricas específicas do produto
• Integrar a skill a fluxos mais amplos (por exemplo, dashboards de analytics, wikis internas de onboarding)

Isso torna onboarding-cro um playbook reutilizável, que pode evoluir junto com seu produto e seu time.