onboard

Installation
Summary

Design or improve onboarding flows that get users to their "aha moment" quickly and successfully.

  • Assess onboarding needs by identifying user challenges, experience level, and the key action you want them to take, then define measurable success metrics
  • Follow core principles: show don't tell, make it optional, prioritize time to value, teach contextually, and respect user intelligence
  • Design for multiple contexts: initial product onboarding (welcome, setup, core concepts, first success), feature discovery (empty states, tooltips, announcements), guided tours, and interactive tutorials
  • Every empty state must explain what will appear, why it matters, how to get started, and include visual interest plus contextual help
  • Track onboarding completion with localStorage to avoid showing the same steps twice, and test with real users to measure time to completion, comprehension, and drop-off points
SKILL.md

MANDATORY PREPARATION

Invoke /impeccable — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run /impeccable teach first. Additionally gather: the "aha moment" you want users to reach, and users' experience level.


Create or improve onboarding experiences that help users understand, adopt, and succeed with the product quickly.

Assess Onboarding Needs

Understand what users need to learn and why:

  1. Identify the challenge:

    • What are users trying to accomplish?
    • What's confusing or unclear about current experience?
    • Where do users get stuck or drop off?
    • What's the "aha moment" we want users to reach?
  2. Understand the users:

Related skills

More from pbakaus/impeccable

Installs
53.4K
GitHub Stars
27.1K
First Seen
Mar 4, 2026