Agent skill

Onboarding Flow

by shawnpang in shawnpang/startup-founder-skills

When the user needs to design, improve, or audit a post-signup activation flow to get new users to their first value moment.

MITAuto-check passed

Install Onboarding Flow

skills CLI
$ npx skills add shawnpang/startup-founder-skills --skill onboarding-flow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shawnpang/startup-founder-skills onboarding-flow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shawnpang/startup-founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/onboarding-flow .claude/skills/onboarding-flow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
onboarding-flow
GitHub stars
343
Token cost
~2.6k tokens
SKILL.md length
1,312 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

When the user needs to design, improve, or audit a post-signup activation flow to get new users to their first value moment.

  • Works in 7 steps: Intake and goal-framing — Read… → Map the current journey — Document every… → Identify friction and drop-off —… → …
  • Needs to design
  • SKILL.md covers When to Use, Context Required, Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Onboarding Flow is an agent skill from shawnpang/startup-founder-skills. When the user needs to design, improve, or audit a post-signup activation flow to get new users to their first value moment. Activate when activation is lagging, time-to-value feels excessive, or first sessions lack impact.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AI agent skills for tech startup founders — fundraising, sales, product, recruiting, engineering, legal, ops, and growth. Works with Claude Code, Cursor, Codex, and any Agent… The licence is MIT.

When your agent uses it

  • Needs to design
  • Audit a post-signup activation flow to get new users to their first value moment

Example prompts

  • “/onboarding-flow”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Intake and goal-framing — Read startup-context if available. Establish the activation goal, current baseline metrics, and what success…
  2. Map the current journey — Document every step from signup to activation event, including screens, emails, wait states, and decision…
  3. Identify friction and drop-off — Pinpoint where users abandon the flow. Categorize blockers: too many steps, unclear value, technical…
  4. Define behavioral activation moments — Identify the specific user actions that predict long-term retention. These become the milestones…
  5. Design the first experience — Apply the progressive onboarding framework to restructure the journey. Focus on the "first 30 seconds"…
  6. Build the milestone-based onboarding plan — Create a "first mile" plan with clear milestones from signup through habit formation, with…
  7. Establish measurement and experiments — Set up tracking for each step in the funnel. Build an experiment backlog prioritized by impact…

What it can do on your machine

Read from SKILL.md and the folder at commit 4ad31b4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Onboarding Flow loads about 2.6k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 1,312 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shawnpang/startup-founder-skills at commit 4ad31b4, republished under its MIT licence (© shawnpang). 1,312 words, ~2,584 tokens.

Download SKILL.mdSave it as .claude/skills/onboarding-flow/SKILL.md (or your agent's skills folder).
name
onboarding-flow
description
When the user needs to design, improve, or audit a post-signup activation flow to get new users to their first value moment. Activate when activation is lagging, time-to-value feels excessive, or first sessions lack impact.
related
support-docs, email-marketing, churn-analysis
reads
startup-context

Onboarding Flow

When to Use

Activate when a founder or product lead needs to design onboarding for new users, improve activation rates, reduce time-to-value, fix drop-off after signup, redesign a guided setup experience, or re-engage users who stalled during onboarding. This includes prompts like "design our onboarding flow," "users are dropping off after signup," "build an activation checklist," "our time-to-value is too long," "how do we get users to their aha moment faster," or "first sessions are not sticking."

Do NOT use for employee onboarding, service process design, or when the product lacks a stable value proposition. This skill is for in-product user activation only.

Context Required

  • From startup-context: product type (B2B/B2C/PLG), target user persona, current activation rate, defined "aha moment," product complexity level, existing onboarding steps, and current tools (email platform, analytics, in-app messaging).
  • From the user: where users currently drop off, the key action that correlates with retention (the activation event), number of steps currently required to reach value, any qualitative feedback from churned users about the setup experience, and what "healthy" first-session behavior looks like.

Workflow

  1. Intake and goal-framing — Read startup-context if available. Establish the activation goal, current baseline metrics, and what success looks like. If the user does not know their activation event, help them hypothesize based on product type (see benchmarks below).
  2. Map the current journey — Document every step from signup to activation event, including screens, emails, wait states, and decision points. Identify friction points, unnecessary steps, and moments of confusion.
  3. Identify friction and drop-off — Pinpoint where users abandon the flow. Categorize blockers: too many steps, unclear value, technical obstacles, cognitive overload, or missing guidance.
  4. Define behavioral activation moments — Identify the specific user actions that predict long-term retention. These become the milestones the onboarding flow drives toward.
  5. Design the first experience — Apply the progressive onboarding framework to restructure the journey. Focus on the "first 30 seconds" experience and minimize steps before first value. Defer non-essential setup.
  6. Build the milestone-based onboarding plan — Create a "first mile" plan with clear milestones from signup through habit formation, with coordinated in-app and email touchpoints.
  7. Establish measurement and experiments — Set up tracking for each step in the funnel. Build an experiment backlog prioritized by impact, confidence, and effort. Design A/B tests for the highest-leverage changes.

Output Format

A comprehensive Onboarding & Activation Pack including:

  1. Activation spec — Defined activation event with behavioral criteria and baseline metrics
  2. First 30 seconds design — The immediate post-signup experience optimized for first value
  3. First mile milestone plan — Stage-by-stage plan from signup through habit formation
  4. Funnel map — Every step with expected conversion rates
  5. In-app UX specifications — Checklists, tooltips, empty states, progress indicators
  6. Email sequence copy — Welcome through re-engagement with timing and triggers
  7. Experiment backlog — Prioritized list of onboarding experiments (impact/confidence/effort)
  8. Measurement framework — Leading indicators, tracking plan, and success criteria
  9. Risk documentation — Open questions, assumptions, and next-step recommendations
Onboarding Funnel Template
Stage 1: Signup -> Profile Setup            (Target: 90%+)
Stage 2: Profile Setup -> First Key Action  (Target: 60-70%)
Stage 3: First Key Action -> Aha Moment     (Target: 50-60%)
Stage 4: Aha Moment -> Habit Formation      (Target: 30-40%)

Frameworks & Best Practices

The Progressive Onboarding Framework

Structure onboarding in three layers that unlock sequentially:

  1. Layer 1: Immediate Value (Minutes 0-5)

    • Get the user to one small win before asking for anything.
    • Pre-fill data where possible (import, templates, sample data).
    • Use empty states as onboarding — every blank screen should guide the next action.
    • Ask only for information required to deliver that first win. Defer everything else.
  2. Layer 2: Core Setup (Day 1-3)

    • Introduce a checklist with 3-5 items (never more than 7). Show progress visually.
    • Each checklist item should unlock a visible capability ("Complete this to enable X").
    • Use contextual tooltips triggered by user behavior, not a grand tour on first login.
    • Send a Day 1 email reinforcing the first win and previewing the next step.
  3. Layer 3: Expansion (Week 1-2)

    • Prompt team invites after the individual user has experienced value (not before).
    • Introduce advanced features through progressive disclosure, not feature dumps.
    • Trigger expansion prompts based on usage patterns, not arbitrary timelines.
Activation Event Benchmarks by Product Type
Product TypeCommon Activation EventTarget Time-to-Value
B2B SaaS (simple)Complete first core workflow< 10 minutes
B2B SaaS (complex)Import data + run first report< 24 hours
PLG / Self-serveInvite first team member + collaborate< 48 hours
Developer toolFirst successful API call or deploy< 30 minutes
B2C appComplete first session/transaction< 3 minutes
Inside-the-Product Onboarding

Prioritize onboarding that happens within the product experience itself, not detached from it. Product tours that overlay the UI without context are less effective than:

  • Empty states that teach — Every blank screen guides the next action
  • Inline prompts — Contextual guidance that appears when the user reaches a decision point
  • Progressive disclosure — Reveal complexity as the user demonstrates readiness
  • Sample data — Let users experience the product's value before investing their own data
Show full SKILL.md (528 more words)Show less
Multi-Channel Coordination Rules
  • In-app: Real-time guidance for active users. Checklists, tooltips, progress bars, empty state CTAs.
  • Email: Async nudges for users who leave. Day 0 welcome, Day 1 reinforcement, Day 3 re-engagement, Day 7 value recap.
  • Push/SMS: Reserve for high-intent signals only ("Your report is ready," "Your teammate just joined"). Never use for generic reminders.
  • Suppression rule: If the user completed the action in-app, suppress the corresponding email. Nothing kills trust faster than "Complete your setup!" emails sent after setup is done.
Checklist Design Principles
  • 3-5 items maximum. Completion rates drop sharply above 5.
  • First item should be pre-completed. Starting with visible progress significantly increases completion rates (endowed progress effect).
  • Each item takes under 2 minutes. If longer, break it into sub-steps.
  • Show the reward. "Connect Slack -> Get instant notifications" not just "Connect Slack."
  • Allow skipping with consequences. Let users skip but show what they lose.
Re-Engagement for Stalled Users

Diagnose before prescribing. Different stall points indicate different problems:

Stall PointLikely CauseIntervention
Signed up, never returnedUnclear value prop or bad timingEmail with specific use case matching signup context
Started setup, abandonedToo many steps or hit a blockerEmail linking directly to where they stopped
Completed setup, never usedNo compelling reason to returnTrigger-based email when something relevant happens
Used once, never returnedFirst experience was not valuableAsk what they were trying to accomplish; offer guided call
Quality Guardrails

All onboarding designs should include:

  • Risk documentation identifying assumptions that could be wrong
  • Open questions that need user research to answer
  • Explicit next steps with owners and timelines
  • Leading indicators to measure before waiting for retention data
  • support-docs — Create help center articles and getting-started guides that support the onboarding flow
  • email-marketing — Build the full lifecycle email program beyond onboarding (retention, expansion, win-back)
  • churn-analysis — When onboarding completion data reveals early churn patterns needing deeper investigation

Examples

Example 1: Designing a new onboarding flow

User: "We're a B2B project management tool. Users sign up but only 20% create their first project. Help us fix onboarding."

Good output excerpt:

Activation Event: Create first project + add at least one task (correlates with 60-day retention).

First 30 Seconds Design: After signup, land on a pre-built sample project (not an empty dashboard). The user sees what the product looks like when populated. A single guided prompt says "Create your first real project" with 3 templates to choose from. After project creation, inline prompt to add a first task with an example. Celebration state: "Your project is live! Invite your team to collaborate."

Expected impact: Reducing pre-value steps from 4 to 2 should increase project creation from 20% to 45-55%.

Example 2: Activation is lagging

User: "We have 3,000 signups from last month and 60% never completed setup. How do we bring them back?"

Good output approach: Segment the 60% by where they stalled. Design different re-engagement emails for each stall point. Include subject lines, body copy, and CTAs linking directly to the abandoned step. Recommend a sunset policy (stop emailing after 30 days to protect deliverability). Build an experiment backlog testing different interventions at each stall point, prioritized by volume of stalled users and estimated recovery rate.

© shawnpang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/onboarding-flow of shawnpang/startup-founder-skills.

Open the folder on GitHubat commit 4ad31b4

Compare with similar skills

Onboarding Flow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Onboarding Flow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Onboarding Flow this skillshawnpang/startup-founder-skills343—~2.6kAutomated safety check: PassMIT
Onboardalirezarezvani/claude-skills28k—~1.3kAutomated safety check: PassMIT
Codebase Onboardingaffaan-m/ECC277k3 repos~2kAutomated safety check: PassMIT
Onboardingsickn33/agentic-awesome-skills47k1 repos~1.8kAutomated safety check: PassMIT
Contributor Onboarding DocDonchitos/Claude-Code-Game-Studios26k—~1.4kAutomated safety check: PassMIT
RuView Onboarding Path Pickerruvnet/RuView97k—~333Automated safety check: PassMIT

Similar skills

  • Onboard

    alirezarezvani/claude-skills

    /cs:onboard — Founder interview that populates ~/.claude/company-context.md using the canonical 7-dimension cs-onboard schema.

    28k GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Analyze an unfamiliar codebase and generate a structured onboarding guide with architecture map, key entry points, conventions, and a starter CLAUDE.md.

    277k GitHub starsUsed in 3 repos~2k tokens
    DevelopmentAuto-check passed
  • Onboarding

    sickn33/agentic-awesome-skills

    When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value.

    47k GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Contributor Onboarding Doc

    Donchitos/Claude-Code-Game-Studios

    Writes an onboarding document for a new contributor or agent, covering project state, conventions and priorities relevant to a chosen role.

    26k GitHub stars~1.4k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Zero-to-sensing path picker for RuView (WiFi-DensePose) — pick docker-demo, repo-build, or live-esp32 and run the next concrete step.

    97k GitHub stars~333 tokensUpdated today
    DevelopmentAuto-check passed
  • 分析一个陌生的代码库,并生成一个结构化的入门指南,包括架构图、关键入口点、规范和一个起始的CLAUDE.md文件。适用于加入新项目或首次在代码仓库中设置Claude Code时。

    277k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed

More from shawnpang/startup-founder-skills

All 50 skills in this repo
  • Accelerator Application

    shawnpang/startup-founder-skills

    When the user wants to apply to startup accelerators, incubators, or fellowship programs.

    343 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Architecture Design

    shawnpang/startup-founder-skills

    When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.

    343 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Board Update

    shawnpang/startup-founder-skills

    When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Churn Analysis

    shawnpang/startup-founder-skills

    When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Cicd Setup

    shawnpang/startup-founder-skills

    When the user needs to set up or improve CI/CD pipelines — GitHub Actions, GitLab CI, deployment automation, or says "set up CI", "automate deployment", "add tests to pipeline", "fix my build".

    343 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    shawnpang/startup-founder-skills

    When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this".

    343 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed

Questions about Onboarding Flow

What does Onboarding Flow do?

When the user needs to design, improve, or audit a post-signup activation flow to get new users to their first value moment. Onboarding Flow is an agent skill from shawnpang/startup-founder-skills. When the user needs to design, improve, or audit a post-signup activation flow to get new users to their first value moment.

When should I use Onboarding Flow?

Onboarding Flow fits situations like: needs to design; audit a post-signup activation flow to get new users to their first value moment.

How do I install Onboarding Flow in Claude Code?

Run `npx skills add shawnpang/startup-founder-skills --skill onboarding-flow -a claude-code`. Or copy the skill folder (skills/onboarding-flow in shawnpang/startup-founder-skills) into .claude/skills/onboarding-flow in your project. Claude Code loads it when a task matches its description.

How do I install Onboarding Flow in Codex?

Run `npx skills add shawnpang/startup-founder-skills --skill onboarding-flow -a codex`. Or copy the skill folder (skills/onboarding-flow in shawnpang/startup-founder-skills) into .agents/skills/onboarding-flow in your project. Codex loads it when a task matches its description.

Can I use Onboarding Flow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shawnpang/startup-founder-skills --skill onboarding-flow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/onboarding-flow, .gemini/skills/onboarding-flow, .github/skills/onboarding-flow and .opencode/skills/onboarding-flow in your project.

What does Onboarding Flow need to run?

SKILL.md names no scripts, command-line tools or credentials: Onboarding Flow is instructions for the agent only.

Does Onboarding Flow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Onboarding Flow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Onboarding Flow use?

Onboarding Flow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Onboarding Flow use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Onboarding Flow?

Skills that share tags, products or a category with Onboarding Flow: Onboard (alirezarezvani/claude-skills, 28k stars), Codebase Onboarding (affaan-m/ECC, 277k stars), Onboarding (sickn33/agentic-awesome-skills, 47k stars) and Contributor Onboarding Doc (Donchitos/Claude-Code-Game-Studios, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Onboarding Flow?

shawnpang (a GitHub user) maintains it in shawnpang/startup-founder-skills, which has 343 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on March 16, 2026.

Source: shawnpang/startup-founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.