
user-onboarding
Help users design effective product onboarding. Use when someone is creating first-user experiences, trying to improve activation rates, designing the first 30 seconds of product usage, or working on the path to the aha moment.
- Installs
- 1.8K
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/refoundai/lenny-skills --skill user-onboarding- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads user-onboarding automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
User Onboarding
Help the user design effective product onboarding using frameworks and insights from 4 product leaders.
How to Help
When the user asks for help with user onboarding:
- Understand the aha moment - Ask what the key value moment is and how quickly users need to reach it
- Design the first 30 seconds - Focus intensely on what happens immediately after signup
- Apply game design principles - Use progressive disclosure and reward mechanics from game design
- Connect to retention - Ensure the onboarding inflects the early user experience toward long-term engagement
Core Principles
Make the first 30 seconds magical
Grant Lee: "We are going to do everything we possibly can to make the first 30 seconds of the product feel magical." The first moments of the user experience are the primary driver for word-of-mouth growth. Invest disproportionately here.
Retention wins come from early experience
Dan Hockenmaier: "Very often I think the biggest wins in retention come from inflecting the early user experience." The onboarding experience is the biggest lever for long-term retention, not just initial activation.
Design from onboarding outward
Merci Grace: "I would design the game from the onboarding experience." Use game design principles where onboarding isn't an afterthought but the foundation from which the rest of the product is built.
Remove blockers to the aha moment
Cam Adams: "We worked a lot on the onboarding process in the last couple of months of launch and that was really pivotal because the product features were there but there was this thing holding people back." Product features may be complete, but invisible friction can prevent users from experiencing them.
Avoid common onboarding anti-patterns
Skip carousels, non-native frameworks, and explanatory screens that don't provide value. Get users into the core product experience as quickly as possible.
Questions to Help Users
- "What is the single moment where users first experience the core value of your product?"
- "What happens in the first 30 seconds after a user signs up?"
- "What friction is between signup and the aha moment, and can any of it be removed?"
- "Have you watched real users go through onboarding and seen where they struggle?"
- "How quickly can a user do something meaningful, not just view something?"
- "What would the onboarding look like if designed like a game tutorial?"
Common Mistakes to Flag
- Explanation screens instead of action - Users learn by doing, not by reading about doing
- Delaying the aha moment - Every screen between signup and value is a potential dropoff point
- Carousels and tooltips - These patterns often indicate the product itself isn't intuitive enough
- Treating onboarding as separate - Onboarding should be designed as part of the core product, not bolted on
- Ignoring the first 30 seconds - This is where most users decide whether to invest further
Deep Dive
For all 4 insights from 4 guests, see references/guest-insights.md
Related Skills
- Measuring Product-Market Fit
- Designing Growth Loops
- Retention & Engagement
- Usability Testing
FAQ
What does the user-onboarding skill do?
Help users design effective product onboarding. Use when someone is creating first-user experiences, trying to improve activation rates, designing the first 30 seconds of product usage, or working on the path to the aha moment.
How do I install user-onboarding?
Run npx skills add https://github.com/refoundai/lenny-skills --skill user-onboarding in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/user-onboarding/ (personal) or .claude/skills/user-onboarding/ (project).
Which AI agents can use user-onboarding?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is user-onboarding safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains user-onboarding?
It is published by refoundai in refoundai/lenny-skills. It has 1,825 recorded installs.
More from refoundai/lenny-skills
personal-productivity
refoundai/lenny-skills
Help users manage their time and tasks more effectively. Use when someone is overwhelmed with work, struggling with focus, trying to balance multiple responsibilities, or asking how to get more done.
writing-prds
refoundai/lenny-skills
Help users transform abstract ideas into actionable project specs that align engineering and design teams on the problem and success metrics.
ai-product-strategy
refoundai/lenny-skills
Help users decide where to apply AI effectively, manage the transition from deterministic to probabilistic software, and build long-term defensibility through verticalization and proprietary data.
competitive-analysis
refoundai/lenny-skills
Help users understand and respond to competition. Use when someone is positioning against competitors, evaluating market threats, running competitive war games, or deciding how much to focus on competitors versus customers.
founder-sales
refoundai/lenny-skills
Help users master the transition from product development to active selling by leveraging their unique status as founders to bridge the trust gap and define a scalable sales motion.
analyzing-user-feedback
refoundai/lenny-skills
Help users convert massive volumes of qualitative and quantitative feedback into high-confidence product decisions through rigorous synthesis and internal immersion.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.