Source profileQuality 90/100

OpenClaudia/openclaudia-skills/skills/onboarding-cro/SKILL.md

onboarding-cro

Improve user onboarding flows to increase activation and retention. Use when asked to design welcome screens, setup wizards, product tours, onboarding checklists, or activation sequences. Trigger phrases: "onboarding flow", "user activation", "welcome screen", "product tour", "onboarding checklist", "first-run experience", "setup wizard", "aha moment", "time to value", "user onboarding", "activation rate".

Source repository stars
662
Declared platforms
0
Static risk flags
1
Last source update
2026-08-24
Source checked
2026-08-25

Decision brief

What it does: where it fits

Design and optimize user onboarding flows that drive activation and long-term retention.

Best for

  • Use when asked to design welcome screens, setup wizards, product tours, onboarding checklists, or activation sequences.

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/OpenClaudia/openclaudia-skills --skill "skills/onboarding-cro"
Safe inspection promptEditorial

Inspect the Agent Skill "onboarding-cro" from https://github.com/OpenClaudia/openclaudia-skills/blob/6b91665a5ab7d36599a605df17dae3e27d5ab242/skills/onboarding-cro/SKILL.md at commit 6b91665a5ab7d36599a605df17dae3e27d5ab242. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    Setup Wizards

    Guided multi-step flows that set up the product for use.

    Maximum 3-5 stepsShow progress indicatorPre-fill defaults where possible
  2. 02

    Setup Flow

    4. Guided setup vs "explore on your own" 5. Pre-populated sample data vs empty state 6. Setup wizard vs onboarding checklist

    Guided setup vs "explore on your own"Pre-populated sample data vs empty stateSetup wizard vs onboarding checklist
  3. 03

    1. Onboarding Frameworks

    The best onboarding flows are organized around the user's job, not the product's features.

    Identify the user's primary job-to-be-doneMap the minimum steps to complete that job in your productGuide the user through those steps, removing all distractions
  4. 04

    Jobs-To-Be-Done (JTBD) Onboarding

    The best onboarding flows are organized around the user's job, not the product's features.

    Identify the user's primary job-to-be-doneMap the minimum steps to complete that job in your productGuide the user through those steps, removing all distractions
  5. 05

    Progressive Disclosure

    Reveal functionality gradually as users demonstrate readiness.

    First session: Only show core functionality needed for primary jobAfter first success: Introduce secondary features that enhance the core workflowAfter repeated use: Surface power features, integrations, customization

Permission review

Static risk signals and limitations

Writes files

medium · line 232

The documentation asks the agent to create, modify, or delete local files.

[ ] Create a design file

Writes files

medium · line 326

The documentation asks the agent to create, modify, or delete local files.

*Activation metric:** Create first design file in first 3 days

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score90/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars662SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
OpenClaudia/openclaudia-skills
Skill path
skills/onboarding-cro/SKILL.md
Commit
6b91665a5ab7d36599a605df17dae3e27d5ab242
License
MIT
Collected
2026-08-25
Default branch
main
View the original SKILL.md

Onboarding CRO

Design and optimize user onboarding flows that drive activation and long-term retention.


1. Onboarding Frameworks

Jobs-To-Be-Done (JTBD) Onboarding

The best onboarding flows are organized around the user's job, not the product's features.

Process:

  1. Identify the user's primary job-to-be-done
  2. Map the minimum steps to complete that job in your product
  3. Guide the user through those steps, removing all distractions
  4. Celebrate completion (aha moment)

Example (Notion):

  • Job: "I need to organize my team's projects"
  • Steps: Create workspace > Invite team > Create first page > Use a template
  • The onboarding flow guides exactly this path, nothing more

Anti-pattern: Feature tours that show every feature. Users do not care about features during onboarding; they care about solving their problem.

Progressive Disclosure

Reveal functionality gradually as users demonstrate readiness.

Levels:

  1. First session: Only show core functionality needed for primary job
  2. After first success: Introduce secondary features that enhance the core workflow
  3. After repeated use: Surface power features, integrations, customization
  4. After mastery: Invite to advanced features, API, automation

Implementation:

  • Use feature flags or user state to control what's visible
  • Track user actions to determine when to advance disclosure level
  • Never show everything at once

Activation Metrics

Define your activation metric before designing onboarding. The activation metric is the action most correlated with long-term retention.

Examples:

ProductActivation MetricTimeframe
SlackSend 2,000 messages (team)First 30 days
DropboxUpload 1 file from 2 devicesFirst 7 days
FacebookAdd 7 friendsFirst 10 days
ZoomHost first meetingFirst 7 days
NotionCreate 3 pagesFirst 7 days
FigmaCreate first designFirst 3 days
HubSpotImport contacts + send first emailFirst 14 days

How to find your activation metric:

  1. Cohort analysis: Compare retained vs churned users
  2. Identify actions that retained users took that churned users did not
  3. Find the action with strongest correlation to 30-day retention
  4. Validate by testing whether guiding users to that action improves retention

Aha Moment Identification

The aha moment is when a user first experiences the core value of your product.

Framework for identifying it:

  1. What do users say when they recommend your product? ("It's amazing because...")
  2. When during their journey do users typically say "wow" or "this is cool"?
  3. What single action separates users who stay from those who leave?

The aha moment is NOT:

  • Signing up
  • Completing onboarding
  • Seeing a feature demo

The aha moment IS:

  • Getting their first result
  • Experiencing time saved
  • Seeing their data visualized for the first time
  • Completing their first task successfully

2. Onboarding Components

Welcome Screens

The first screen after signup. Serves two purposes: make the user feel welcomed and collect information for personalization.

Best Practices:

  • Use the user's name ("Welcome, Sarah!")
  • Keep it to 1-3 questions maximum
  • Use visual selectors (cards with icons) instead of dropdowns
  • Every question should directly affect their experience
  • Always allow skipping

Template:

Welcome to [Product], [Name]!

Let's personalize your experience.

What's your primary goal?
[ ] [Goal 1 -- with icon]
[ ] [Goal 2 -- with icon]
[ ] [Goal 3 -- with icon]
[ ] Something else

[Continue]  [Skip for now]

Example (Notion):

What will you use Notion for?
[Personal] [Team] [School]

How big is your team?
[Just me] [2-10] [11-50] [50+]

Setup Wizards

Guided multi-step flows that set up the product for use.

When to use: When the product requires configuration before it can deliver value (CRM, analytics, marketing automation).

Best Practices:

  • Maximum 3-5 steps
  • Show progress indicator
  • Pre-fill defaults where possible
  • Allow skipping non-essential steps
  • Provide "try it with sample data" option
  • End with a clear next action, not a blank screen

Template:

Step 1: Connect your [data source]
  [Connect Google] [Connect manually] [Use sample data]

Step 2: Configure your [workspace/project]
  [Pre-filled sensible defaults with edit option]

Step 3: Invite your team (optional)
  [Email input] [Copy invite link] [Skip]

You're all set!
  [Go to your dashboard]

Product Tours

Interactive walkthroughs of the product interface.

Types:

  1. Tooltip tour: Highlights UI elements with explanatory tooltips (Intercom, Appcues)
  2. Video walkthrough: Short video showing key workflows
  3. Interactive tutorial: User performs real actions with guidance
  4. Sandbox mode: Pre-populated environment for safe exploration

Best Practices:

  • Keep tours under 5 steps (3 is ideal)
  • Focus on ONE workflow per tour
  • Let users exit at any point
  • Make the user DO something, not just read
  • Trigger contextually (first time visiting a feature), not globally
  • Never replay completed tours unless user requests it

Anti-patterns:

  • 15-step tours that show every button
  • Forced tours that cannot be dismissed
  • Tours that explain obvious UI elements
  • Tours that trigger repeatedly

Template (per step):

Step [X] of [Y]:

[Pointer to UI element]

"[Action verb] here to [achieve result]."

[Try it now] / [Next] / [Skip tour]

Onboarding Checklists

Persistent task lists that guide users through activation.

Why they work:

  • Zeigarnik effect: People feel compelled to complete unfinished tasks
  • Clear progress visualization
  • Users self-pace through the list
  • Can be dismissed and revisited

Template:

Get started with [Product]  [3/5 complete]

[x] Create your account
[x] Set up your profile
[x] [First key action]
[ ] [Second key action] <-- "Do this next"
[ ] [Third key action]

[Dismiss checklist]

Best Practices:

  • 4-6 items maximum
  • Pre-check easy items (account creation) for momentum
  • Order by dependency and importance
  • Highlight the next recommended step
  • Celebrate completion (confetti, badge, reward)
  • Include at least one "aha moment" action
  • Show percentage complete or progress bar

Example (Slack):

Getting started  [2/4]
[x] Set your profile photo
[x] Join a channel
[ ] Send your first message
[ ] Invite a teammate

Example (Figma):

Welcome to Figma  [1/5]
[x] Create your account
[ ] Create a design file
[ ] Add a frame
[ ] Use a component
[ ] Share with your team

Email Onboarding Sequences

Drip emails that complement the in-app experience.

Sequence structure:

DayEmailPurpose
0Welcome + quick startImmediate value, link to first action
1Tip: [Core feature]Teach one key feature
3Social proofShow what others achieve with the product
5"Need help?"Address common obstacles, offer support
7Feature highlightIntroduce a secondary feature
10Activation reminderIf not activated, nudge toward key action
14Upgrade promptIf activated, pitch premium features

Day 0 Welcome Email Template:

Subject: Welcome to [Product] -- here's your quick start

Hi [Name],

You're in! Here's how to get the most out of [Product] in the next 5 minutes:

1. [First action] -- [link directly to it]
2. [Second action] -- [link]
3. [Third action] -- [link]

[Primary CTA: "Go to your dashboard"]

Need help? Reply to this email or check our [getting started guide].

[Signature]

Day 3 Social Proof Email Template:

Subject: How [Customer] uses [Product] to [Result]

Hi [Name],

Did you know that [Customer/Company] uses [Product] to [specific result with metric]?

Here's what they did:
1. [Step they took]
2. [Step they took]
3. [Result they achieved]

You can do the same:
[CTA: "Try it now"]

3. Onboarding Examples from Top Products

Notion

What they do well:

  • Welcome screen asks role + use case (2 questions)
  • Offers templates based on selection
  • Pre-populates workspace with starter content
  • Progressive disclosure: basic blocks first, databases later
  • Checklist in sidebar tracks setup progress
  • Empty states have clear CTAs

Activation metric: Create 3+ pages in first 7 days

Slack

What they do well:

  • Workspace setup wizard is 3 steps (name, invite, channel)
  • Slackbot guides first interactions conversationally
  • Pre-created #general and #random channels with welcome messages
  • Teaches features by having users use them (send a message, react with emoji)
  • Onboarding checklist in sidebar

Activation metric: Team sends 2,000 messages in first 30 days

Figma

What they do well:

  • Minimal signup (Google OAuth one-click)
  • Immediately drops user into a canvas with interactive tutorial
  • Tutorial teaches by doing (create shape, move it, style it)
  • Sample files available to explore
  • Team collaboration demonstrated early (cursor presence)

Activation metric: Create first design file in first 3 days

Canva

What they do well:

  • Asks "What will you design today?" with visual categories
  • Immediately shows templates relevant to selection
  • First design experience uses pre-made template (user edits, not creates from scratch)
  • Celebrates first download with sharing prompt

Linear

What they do well:

  • Import from existing tools (Jira, Asana) as first step
  • Pre-configured with sensible defaults (workflow states, labels)
  • Keyboard shortcuts taught in context
  • Empty states show exactly what to do next

4. Measuring Onboarding Success

Key Metrics

MetricFormulaTarget
Onboarding completion rateUsers who complete onboarding / signups60-80%
Time to first key actionTime from signup to first meaningful actionUnder 5 min
Activation rateUsers hitting activation metric / signups20-40%
Day 1 retentionUsers returning day after signup / signups40-60%
Day 7 retentionUsers returning 7 days after signup / signups20-35%
Day 30 retentionUsers active 30 days after signup / signups10-25%
Onboarding step drop-offUsers completing step N / users starting step NTrack per step
Time to value (TTV)Median time from signup to aha momentAs low as possible

Funnel Analysis

Build an onboarding funnel in your analytics tool:

Signup completed
  -> Welcome screen completed
    -> First key action
      -> Second key action (aha moment)
        -> Activation metric reached
          -> Day 7 return

Track conversion rate between each step. The biggest drop-off is your biggest opportunity.


5. A/B Test Ideas for Onboarding

Welcome Screen

  1. 1 question vs 3 questions on welcome screen
  2. Visual card selection vs dropdown
  3. Personalized template suggestions vs generic

Setup Flow

  1. Guided setup vs "explore on your own"
  2. Pre-populated sample data vs empty state
  3. Setup wizard vs onboarding checklist

Product Tour

  1. Tooltip tour vs video walkthrough
  2. 3-step tour vs 5-step tour
  3. Auto-triggered tour vs user-initiated

Activation

  1. Email nudge on day 1 vs day 3 for inactive users
  2. In-app prompt for next action vs no prompt
  3. Celebrating milestones (confetti, badge) vs no celebration
  4. Showing progress ("You're 60% set up") vs not showing

Engagement

  1. Daily tip emails vs weekly digest
  2. Push notifications for incomplete onboarding vs email only
  3. Peer comparison ("Teams like yours usually...") vs no comparison

6. Onboarding Audit Template

When auditing an existing onboarding flow:

## Onboarding Audit: [Product Name]
### Date: [Date]

### Current Flow Map
[Step-by-step flow with screenshots]

### Time to Complete
- Minimum path: [X] minutes
- Average path: [X] minutes

### Drop-off Analysis
| Step | Users Entering | Completion Rate | Drop-off |
|------|---------------|-----------------|----------|
| Signup | 100% | X% | X% |
| Welcome screen | X% | X% | X% |
| Setup step 1 | X% | X% | X% |
| Setup step 2 | X% | X% | X% |
| First key action | X% | X% | X% |
| Activation | X% | -- | -- |

### Scores (1-10)
| Dimension | Score | Notes |
|-----------|-------|-------|
| Time to value | X | |
| Clarity of next step | X | |
| Progressive disclosure | X | |
| Error recovery | X | |
| Mobile experience | X | |
| Personalization | X | |
| **Overall** | **X** | |

### Issues Found
1. **[Critical]** [Issue] -- Impact: [X]% activation loss
2. **[High]** [Issue]
3. **[Medium]** [Issue]

### Recommendations (Priority Order)
1. [Recommendation] -- Expected lift: X% on [metric]
2. [Recommendation] -- Expected lift: X%
3. [Recommendation] -- Expected lift: X%

### Quick Wins
- [ ] [Immediate fix]
- [ ] [Immediate fix]

### Long-term Improvements
- [ ] [Bigger initiative]
- [ ] [Bigger initiative]

7. Common Onboarding Mistakes

  1. Showing everything at once -- Overwhelms users. Use progressive disclosure.
  2. Explaining features, not outcomes -- "This is our dashboard" vs "See your results here."
  3. Forcing completion before value -- Let users explore, then guide.
  4. No empty state strategy -- Blank screens kill activation. Use templates, samples, or guided prompts.
  5. One-size-fits-all flow -- Different user types need different onboarding paths.
  6. Ignoring mobile -- Mobile onboarding needs its own design (not a shrunk desktop flow).
  7. No re-engagement for drop-offs -- Users who abandon onboarding need targeted email nudges.
  8. Celebrating signup, not activation -- "Welcome!" is not the goal. The first success moment is.
  9. Too many tooltips -- If you need 10 tooltips, your UI is too complex.
  10. No measurement -- If you are not tracking step-by-step drop-offs, you are guessing.

Frequently asked questions

What to verify before installation and use

What does the onboarding-cro source document cover?

Design and optimize user onboarding flows that drive activation and long-term retention.

How do I install onboarding-cro?

The source record exposes this install command: npx skills add https://github.com/OpenClaudia/openclaudia-skills --skill "skills/onboarding-cro". Inspect the command and pinned source before running it.

Which permission-related actions were detected?

Static rules flagged write-files in the source; the page lists the matching lines and excerpts.

Alternatives

Compare before choosing

Computed 10045,511

coreyhaines31/marketingskills

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program

Computed 1008

narrative-io/narrative-skills-marketplace

design-analysis

Translate a fuzzy analytical question into a rigorous investigation plan. Interrogates the ask, grounds the plan in the available data dictionary, applies analytical best practices, and produces a structured brief of query specifications for a downstream query-writing skill. Plans, does not write SQL. Use when: "why did X drop", "is there a relationship between A and B", "who are our highest-value customers", "what's driving the change in Y", "investigate this trend", "design an analysis for", "

Computed 97269

Aperivue/medsci-skills

calc-sample-size

Interactive sample size calculator for medical research. Decision-tree guided test selection, reproducible R/Python code, effect size interpretation, and IRB-ready justification text. Supports diagnostic accuracy, agreement, proportions, continuous outcomes, survival, ANOVA, logistic regression, and non-inferiority/equivalence designs.

Computed 97223

yonatangross/orchestkit

verify

Grade work that already exists and decide whether it can merge. Runs the project's current unit, integration, and E2E suites plus security scanning and type checking, scores every dimension 0-10, and returns a merge verdict with a VERIFIED-vs-CLAIMED evidence manifest. Writes no test files and edits no source. Use when verifying changes are ready to merge. Use /ork:cover instead when the tests still have to be written.