Onboarding Copy Skill
The best onboarding doesn't tour features — it walks the user to their first real win (the "aha" where the
product's value clicks). This skill writes the copy for that path: a welcome that sets the outcome, tooltips
that guide the few steps that matter, and a success moment that confirms it worked — concise, encouraging, and
skippable.
Working from a brief
Given "onboarding for a habit-tracking app", write the flow copy anyway — infer the activation moment (the
first win), the minimal steps to reach it, and the voice, labelling assumptions. Focus the copy on the outcome,
not a feature list. Never hand back a question instead of copy.
Required Inputs
Ask for these only if they aren't already provided (else infer and label):
- The product & first win — what it does, and the "aha" moment that means a user is activated.
- The path to it — the minimal steps a new user takes to reach that first win.
- Format — modals, tooltips/coachmarks, a checklist, inline hints, or empty-state prompts.
- Voice & constraints — tone, length limits, and whether steps are skippable (they should be).
Output Format
Onboarding Copy: [product]
- Welcome — a short opener that states the outcome ("Let's set up your first X") — value, not features.
- Guided steps — for each step toward the first win: a tooltip/coachmark with a tight instruction, why it matters (one phrase), and the action label. Keep it to the few steps that matter; let users skip.
- Progress & nudges — checklist item labels, progress encouragement, and empty-state prompts that pull users to the next action.
- First-win moment — the success message when they hit activation — celebrate it specifically, then point to the natural next step.
- Re-engagement — a line or two for users who dropped off mid-setup (gentle, value-reminding).
Keep every piece concise, encouraging, and outcome-focused; note where copy must fit a tight space.
Quality Checks
Anti-Patterns
Based On
Product onboarding & activation practice — outcome-led welcome, guided path to the first win, progress nudges, and a celebrated activation moment.
Example Trigger Phrases
- "Write onboarding copy."
- "Write our welcome flow."
- "Write the product tour tooltips."
- "Write activation messages for new users."
1---2name: onboarding-copy3description: "Write in-product onboarding copy that gets users to value fast. Use when asked to write onboarding copy, a welcome flow, product tour/tooltips, setup steps, or activation messaging. Produces the copy for an onboarding flow — welcome, the guided steps/tooltips toward the first win, progress and empty-to-active nudges, and a success moment — focused on the activation outcome, not a feature tour."4disable-model-invocation: true # skill-optimizer5metadata:6 source: https://skillmd.com/skills/slipcast-dev/onboarding-copy7---89# Onboarding Copy Skill1011The best onboarding doesn't tour features — it walks the user to their **first real win** (the "aha" where the12product's value clicks). This skill writes the copy for that path: a welcome that sets the outcome, tooltips13that guide the few steps that matter, and a success moment that confirms it worked — concise, encouraging, and14skippable.1516## Working from a brief1718Given "onboarding for a habit-tracking app", **write the flow copy anyway** — infer the activation moment (the19first win), the minimal steps to reach it, and the voice, labelling assumptions. Focus the copy on the outcome,20not a feature list. Never hand back a question instead of copy.2122## Required Inputs2324Ask for these only if they aren't already provided (else infer and label):2526- **The product & first win** — what it does, and the "aha" moment that means a user is activated.27- **The path to it** — the minimal steps a new user takes to reach that first win.28- **Format** — modals, tooltips/coachmarks, a checklist, inline hints, or empty-state prompts.29- **Voice & constraints** — tone, length limits, and whether steps are skippable (they should be).3031## Output Format3233### Onboarding Copy: [product]3435- **Welcome** — a short opener that states the **outcome** ("Let's set up your first X") — value, not features.36- **Guided steps** — for each step toward the first win: a tooltip/coachmark with a tight instruction, *why it matters* (one phrase), and the action label. Keep it to the few steps that matter; let users skip.37- **Progress & nudges** — checklist item labels, progress encouragement, and empty-state prompts that pull users to the next action.38- **First-win moment** — the success message when they hit activation — celebrate it specifically, then point to the natural next step.39- **Re-engagement** — a line or two for users who dropped off mid-setup (gentle, value-reminding).4041Keep every piece concise, encouraging, and outcome-focused; note where copy must fit a tight space.4243## Quality Checks4445- [ ] The flow drives toward one clear activation outcome, not a feature tour46- [ ] Each step is concise and says why it matters, not just what to click47- [ ] Steps are skippable / non-blocking — onboarding guides, it doesn't trap48- [ ] There's an explicit first-win success moment that's specific, not generic49- [ ] Tone is encouraging and matches the product voice50- [ ] Empty-state and drop-off nudges move users to the next action5152## Anti-Patterns5354- [ ] Do not tour every feature — guide to the first win; the rest can be discovered55- [ ] Do not write blocking, un-skippable walls of modals — let users get to the product56- [ ] Do not explain what's obvious ("This is the menu") — spend words where there's real friction57- [ ] Do not forget the success moment — activation should feel rewarded58- [ ] Do not be generically chirpy — encouragement should be specific to what they just did5960## Based On6162Product onboarding & activation practice — outcome-led welcome, guided path to the first win, progress nudges, and a celebrated activation moment.6364## Example Trigger Phrases6566- "Write onboarding copy."67- "Write our welcome flow."68- "Write the product tour tooltips."69- "Write activation messages for new users."