App Onboarding Questionnaire
A Claude Code skill that designs and builds high-converting questionnaire-style onboarding flows for your app — modelled on proven conversion patterns from top subscription apps like Mob, Headspace, Noom, and Duolingo.
What It Does
Run /app-onboarding-questionnaire from your app project and the skill will:
- Analyse your codebase to understand what your app does, who it's for, and what permissions it needs
- Define the user transformation — the before/after story that drives your onboarding narrative
- Design a screen-by-screen blueprint using a proven 14-screen psychological framework
- Draft all the copy — headlines, questions, options, CTAs, social proof
- Build the onboarding flow in your app's native framework (SwiftUI, React Native, Flutter, etc.)
No marketing expertise required. The skill handles the conversion psychology — you just answer questions about your app.
The Framework
The onboarding follows a proven psychological sequence used by the highest-converting subscription apps:
| # | Screen | Purpose |
|---|---|---|
| 1 | Welcome | Hook — show the end state, create desire |
| 2 | Goal Question | "What are you trying to achieve?" — creates psychological investment |
| 3 | Pain Points | "What prevents you?" — surfaces frustrations, builds empathy |
| 4 | Social Proof | Testimonials matched to user personas |
| 5 | Tinder Cards | Swipe agree/disagree on pain statements — interactive self-identification |
| 6 | Personalised Solution | Mirror their pains back with stats showing how the app solves each one |
| 7 | Comparison Table | Life with vs without the app (optional) |
| 8 | Preferences | Functional personalisation that feeds the upcoming demo |
| 9 | Permission Priming | Benefit-framed pre-sell before system permission dialogs (auto-detected) |
| 10 | Processing Moment | "Building X just for you..." — anticipation builder |
| 11 | App Demo | User actually USES the core app mechanic — not a tour, a real interaction |
| 12 | Value Delivery | Tangible output from their demo + share/viral moment |
| 13 | Account Gate | Optional sign-in to unlock what they just created |
| 14 | Paywall | Hard paywall with trial, social proof, and pricing |
Not every app needs every screen — the skill adapts based on your app's complexity.
What Makes This Different
Most onboarding generators stop at the questionnaire. This skill goes further:
- App Demo Screen — Builds a functional mini-version of your app's core interaction inside the onboarding. Users pick recipes, choose exercises, categorise transactions — whatever your core loop is. They DO something and get a tangible result back.
- Viral Moment — The demo output is designed to be shareable. This is where organic growth comes from.
- Permission Priming — Auto-detects permissions from your codebase (Info.plist, AndroidManifest, etc.) and creates benefit-framed priming screens that convert at 70-80%+ vs ~40% for cold system prompts.
- Resumable — Progress is saved to Claude Code's memory system. Come back tomorrow and pick up where you left off.
Installation
Option 1: Add to your Claude Code skills directory
cd ~/.claude/skills
git clone https://github.com/adamlyttleapps/claude-skill-app-onboarding-questoinnaire.git app-onboarding-questionnaire
Option 2: Add as a dependency in your project's .claude/settings.json
{
"skills": [
"github:adamlyttleapps/claude-skill-app-onboarding-questoinnaire"
]
}
Usage
From your app's project directory in Claude Code:
/app-onboarding-questionnaire
The skill will analyse your codebase and walk you through each phase interactively.
Reference
The framework is based on analysis of the Mob recipe app's onboarding flow (19 screens), which is widely regarded as one of the best-converting onboarding experiences in the App Store.
License
MIT