onboard

Overview

The onboard skill is designed to help teams and product owners create and refine onboarding flows, empty states, and first-run experiences that guide users to value quickly. This skill is ideal for anyone focused on user activation, improving first-time user journeys, or reducing friction in getting started with a product or service. By following structured onboarding principles, the onboard skill ensures that new users understand the product, avoid common pitfalls, and reach their "aha moment" efficiently.

Who should use the onboard skill?

• UI/UX designers seeking to optimize onboarding and activation flows
• Product managers aiming to improve user retention and reduce drop-off
• Developers and teams responsible for first-run user experiences

What problems does onboard solve?

• Confusing or incomplete onboarding processes
• High user drop-off during initial product use
• Ineffective empty states or unclear first steps for new users

How to Use

Installation Steps

1. Install the onboard skill using the following command:

   npx skills add https://github.com/pbakaus/impeccable --skill onboard

2. Start by reviewing the SKILL.md file in the skill directory. This file outlines the core onboarding workflow, preparation steps, and key principles.

3. For additional context, check related files such as README.md, AGENTS.md, and any supporting folders like rules/, resources/, or references/ if available in the repository.

Getting Started with onboard

• Mandatory Preparation: Before using onboard, invoke the /frontend-design skill to gather design context and avoid anti-patterns. If no design context exists, run /teach-impeccable first. Collect information about your users' experience level and the key "aha moment" you want them to reach.
• Assess Onboarding Needs: Identify where users struggle, what they need to learn, and how you will measure onboarding success. Consider user motivations, experience levels, and the minimum actions required for success.
• Apply Onboarding Principles: Use the guidance in SKILL.md to design onboarding flows that show rather than tell, minimize friction, and clearly guide users to their first success.

Adapting onboard to Your Workflow

• Integrate the onboard skill into your existing design or development process.
• Use the provided protocols and checklists to evaluate and improve your onboarding flows.
• Customize recommendations based on your product’s unique user base and goals.

FAQ

When should I use the onboard skill?

Use onboard whenever you need to design or improve onboarding, empty states, or first-run experiences—especially if users mention confusion, drop-off, or difficulty getting started.

What files are most important for onboarding?

Begin with SKILL.md for the main workflow and principles. Explore other documentation and resource folders for deeper guidance.

Do I need other skills to use onboard effectively?

Yes, for best results, run /frontend-design first to gather necessary design context. If your team lacks onboarding experience, consider running /teach-impeccable as well.

Is onboard suitable for all types of products?

The onboard skill is best for digital products and services where user activation and first impressions are critical. It may not be as relevant for products without a user interface or where onboarding is not a concern.

Where can I find more details or support?

Visit the onboard skill directory on GitHub for the latest files and updates. Open the Files tab to browse all resources and scripts.