agentleFS
BappozBappoz/My-Claude-Skills/skills/product/user-onboarding/SKILL.md

user-onboarding

Skill1 starsChanged 4 months agoMITView on GitHub

Design de onboarding de produto: ativação, time-to-value, aha moment, empty states, tours e checklists, reduzindo fricção do primeiro uso. Use quando o usuário mencionar: "onboarding", "primeiro uso", "ativação", "time-to-value", "empty state", "tour", "walkthrough", "novo usuário", "setup wizard", "não sei usar o app", "retenção inicial". Liga com [[growth]] e [[ux-copy]].

9 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

User Onboarding

Você atua como product designer focado em ativação. Objetivo: levar o novo usuário ao valor (aha moment) o mais rápido possível. Onboarding não é um tour bonito — é remover tudo entre "abriu o app" e "percebeu por que vale a pena". A primeira sessão decide a retenção (liga com [[growth]]).

Princípio: time-to-value acima de tudo

Cada segundo/passo antes do valor perde usuários. Meça e reduza o time-to-value (TTV): o tempo até o usuário viver o benefício central pela primeira vez. Corte, adie ou automatize tudo que não leva a isso.

Encontre o aha moment

O "aha" é a ação que prevê retenção (ex: Slack = "2.000 mensagens trocadas pela equipe"; Facebook = "7 amigos em 10 dias"). Todo o onboarding é uma reta para levar o usuário até lá.

  • Descubra-o com dados: que ação, na 1ª semana, separa quem fica de quem sai? (análise de coorte — ver [[growth]]).
  • Depois, projete o fluxo para conduzir até essa ação com o mínimo de atrito.

Reduzir fricção (o trabalho principal)

  • Adie o que dá para adiar — não peça tudo no cadastro; peça no momento de valor. Cartão só quando for cobrar; permissões quando a feature precisar.
  • Defaults inteligentes / templates — comece com algo pronto, não uma tela vazia. Preencha o que der.
  • Progressive disclosure — ensine no contexto, quando a feature aparece, não num tutorial gigante no começo.
  • Login social / SSO — menos senha, menos abandono.
  • Mostre progresso — barra/checklist reduz abandono (efeito de conclusão).

Empty states que ativam

O estado vazio é a primeira coisa que o usuário vê — trate como onboarding, não como "sem dados".

Empty state bom = o que é isso + por que importa + 1 ação clara (+ opção de exemplo/template)

Ex: lista de projetos vazia → "Crie seu primeiro projeto para organizar seu time" + [Criar projeto] + [Usar template]. Ver [[ux-copy]] para o texto.

Padrões (use o certo, não todos)

PadrãoBom paraCuidado
Checklist de setupGuiar múltiplos passos, mostrar progressoNão liste tarefas irrelevantes
Tooltip contextualEnsinar no momento do usoNão encha a tela de balões
Product tourVisão geral rápidaTour longo é pulado; mantenha curto e pulável
Template/sample dataTela vazia → valor imediatoDeixe claro que é exemplo
Onboarding progressivoEnsinar ao longo do usoExige rastrear o que já foi visto

Regra: fazer > assistir. Onboarding que faz o usuário agir (criar algo real) retém mais que tutorial passivo.

Segmentar (um onboarding não serve a todos)

Pergunte pouco (1-2 perguntas) para ramificar: o dev e o gerente têm "ahas" diferentes; leve cada persona ao seu valor. Não faça um questionário longo — cada pergunta custa usuários.

Medir

  • Taxa de ativação — % que atinge o aha moment (a métrica-mãe).
  • Funil de onboarding — onde caem passo a passo (ache o degrau que perde mais).
  • TTV — tempo mediano até o valor.
  • Retenção D1/D7 por coorte de onboarding (o novo fluxo reteve mais?).

Recursos externos

RecursoO que pegar
Reforge — ActivationFrameworks de ativação e aha moment.
NN/g — OnboardingPadrões de UX de onboarding baseados em pesquisa.
Useronboard.comTeardowns de onboarding de produtos reais.
Appcues — Onboarding patternsChecklists, tours, empty states na prática.
[[growth]] · [[ux-copy]]Retenção/coortes e o texto do onboarding.

Do / Don't

DoDon't
Reta para o aha momentTour genérico sem valor
Adiar pedidos até o momento certoFormulário longo no cadastro
Templates/sample dataTela vazia intimidadora
Fazer (agir) > assistirTutorial passivo longo
Empty state com 1 ação clara"Nenhum dado" e ponto

Checklist

  • Aha moment identificado por dados (prediz retenção)
  • Fluxo é a reta mais curta até esse valor (TTV medido)
  • Fricção removida (adiar pedidos, defaults, SSO)
  • Empty states com propósito + 1 ação
  • Usuário age (cria algo real), não só assiste
  • Segmentação leve por persona (1-2 perguntas)
  • Ativação e funil de onboarding medidos por coorte

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.