onboard

Design onboarding flows and first-run experiences for web and mobile interfaces.

Updated Apr 19, 2025
One-click install
npx skills add https://github.com/adperem/adperem.github.io --skill onboard-adperem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onboard
Source: https://github.com/adperem/adperem.github.io/tree/main/.agents/skills/onboard
Command: npx skills add https://github.com/adperem/adperem.github.io --skill onboard-adperem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboarding deficiencies slow user activation, cause confusion, and hinder quick value realization. This skill provides a structured design approach to crafting onboarding flows, empty states, and first-run experiences that help users reach value faster.

Core Features & Use Cases

  • Framework for identifying onboarding needs, crafting empty states, and guiding first-time users.
  • Principles include Show, Don't Tell; Time to Value; Context Over Ceremony; and Progressive Onboarding.
  • Use Case: Design onboarding for a new feature or improve activation and retention through guided setup.

Quick Start

Draft an onboarding flow for a new user that guides them to value quickly.

Frequently Asked Questions about onboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to design onboarding flows for new users?

The best way to design onboarding flows is to apply principles like Show Don't Tell, Time to Value, and Progressive Onboarding to guide users to value quickly. This approach structures first-run experiences and empty states to maximize user activation across web and mobile interfaces.

How do I create an effective first-run experience for a web or mobile app?

Creating an effective first-run experience requires defining the user's aha-moment and using progressive disclosure to reveal features gradually. This ensures new users are guided through setup smoothly without being overwhelmed by unnecessary ceremony.

How do empty states help with user activation during onboarding?

Empty states help with user activation by providing clear guidance and context when a user encounters a blank screen for the first time. They act as a critical onboarding touchpoint that guides first-time users on exactly what actions to take next to reach value.

Can I use progressive disclosure to improve onboarding for complex features?

You can use progressive disclosure to improve onboarding by revealing interface complexity only as needed during the first-run experience. This design technique prevents cognitive overload and aligns with the Context Over Ceremony principle to speed up time to value.

When should I redesign an existing first-run experience or onboarding flow?

You should redesign an onboarding flow when user activation metrics drop, indicating slow time to value and confusion during setup. Improving the first-run experience with structured guidance and better empty states directly addresses these deficiencies and accelerates retention.