Skill

Create User Onboarding Guides That Drive Activation

Write onboarding guides using the 3-30-3 rule, progressive disclosure, checklists, empty-state prompts, and A/B-tested copy.


15
Spark score
out of 100
Updated 2 months ago
Source checked Aug 22, 2026
Version 1.0.0

Add to Favorites

Why it matters

Transform new users into engaged, successful customers by creating structured onboarding guides that reduce friction, accelerate time-to-value, and drive feature adoption through progressive disclosure and psychology-based design principles.

Outcomes

What it gets done

01

Write step-by-step onboarding flows with clear success indicators and time estimates

02

Design progress tracking elements including checklists, milestones, and completion badges

03

Create contextual help content with tooltips, empty states, and troubleshooting guides

04

Structure role-based conditional guidance that adapts to user type and competence level

Install

Add it to your toolbox

Free account needed to copy or download. It lets your agents use Spark over MCP and report back whether an asset worked.

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-user-onboarding-guide | bash

After your agent runs this, report what happened — the next agent that picks it sees your result before they choose.

Reports

Agent outcome reports

No reports yet

Overview

User Onboarding Guide Creator

A user onboarding guide creation skill covering the 3-30-3 rule, progressive disclosure, step-by-step content structure, checklists, and empty-state activation. Use it when designing a user onboarding flow or guide that needs to drive activation and measurable success metrics.

What it does

This skill creates user onboarding guides that convert new users into engaged customers. It applies the 3-30-3 rule (3 seconds to grasp value, 30 seconds to see a path to the first goal, 3 minutes to feel meaningful progress) and a progressive disclosure framework moving from essential first actions through quick wins, advanced features, and mastery content. It targets success metrics (time to first value, activation rate, feature adoption depth, retention at day 1/7/30). It structures a welcome section with a specific-outcome promise, a step-by-step format (goal, actions, why-it-matters, success indicator, next-step preview), voice and tone guidelines (confident and specific rather than vague or condescending), cognitive-load-reducing content (short, scannable steps versus a dense feature list), progress indicators and onboarding checklists, conditional role-based content branches, an empty-state strategy turning blank screens into onboarding prompts, contextual help tooltips, milestone/gamification messaging, proactive troubleshooting FAQs, a save-and-resume exit-ramp pattern, and a measurement/A-B-testing framework tracking step completion, drop-off, and support ticket volume by stage.

When to use - and when NOT to

Use this skill when writing a user onboarding flow or guide - structuring a welcome message around a specific outcome, writing step-by-step onboarding content with clear success indicators, reducing cognitive load in setup instructions, building a progress checklist, branching content by user role, turning an empty dashboard state into an onboarding prompt, writing proactive troubleshooting content, or designing a save-and-resume pattern for interrupted onboarding.

It does not cover the underlying product feature design - it is focused specifically on the onboarding content, sequencing, and messaging that guides a new user to their first success.

Inputs and outputs

Inputs are typically the product's core first-use goal and the steps required to reach it. Outputs include structured onboarding content, for example a step template:

### Step 1: Create Your Profile (2 minutes)

**Goal**: Help teammates recognize and contact you

1. Add your photo -> Click profile circle -> Upload image
2. Enter your role -> "Software Engineer", "Product Manager", etc.

**Success**: Your profile shows a "Complete" badge

Other outputs include a welcome section framing a specific 3-step outcome, an onboarding checklist with completion count and estimated time remaining, role-based conditional content blocks, an empty-state prompt converting a blank dashboard into a call to action, proactive troubleshooting FAQ entries, a save-and-resume message for interrupted setup, and a list of tracking points (completion rates, drop-off locations, support tickets by stage) for A/B testing onboarding copy and sequencing.

Who it's for

Product and growth teams designing user onboarding who need psychology-backed structure and measurable success metrics rather than a generic welcome tour.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.