heymegabyte/agent-skills / 06-build-and-slice-loop
build-and-slice-loop
VerifiedUse when implementing features or streaming OnePrompt site builds. Complete vertical slices with real content, strict TypeScript and Zod. Parallel section/data work, deterministic assembly, granular patches and immediate valid previews.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.2 KB |
| admin-dashboard.md | markdown | 5.5 KB |
| ai-chat-widget.md | markdown | 6.0 KB |
| blog-and-content-engine.md | markdown | 6.2 KB |
| build-breaking-rules.md | markdown | 7.4 KB |
| chat-native-dashboard.md | markdown | 3.6 KB |
| contact-forms-and-endpoints.md | markdown | 6.7 KB |
| copilot-and-ai-features.md | markdown | 7.4 KB |
| custom-error-pages.md | markdown | 4.5 KB |
| data-tables.md | markdown | 7.7 KB |
| domain-provisioning.md | markdown | 4.6 KB |
| easter-eggs.md | markdown | 4.7 KB |
| empty-states-and-loading.md | markdown | 5.7 KB |
| file-uploads-and-storage.md | markdown | 6.7 KB |
| internationalization.md | markdown | 4.3 KB |
| keyboard-shortcuts-and-command-palette.md | markdown | 6.7 KB |
| microcopy-library.md | markdown | 8.0 KB |
| notification-center.md | markdown | 8.4 KB |
| onboarding-and-first-run.md | markdown | 5.0 KB |
| pre-digested-builds.md | markdown | 3.6 KB |
| pwa-kit.md | markdown | 6.8 KB |
| realtime-and-websockets.md | markdown | 7.2 KB |
| rich-text-editor.md | markdown | 7.4 KB |
| site-search.md | markdown | 4.0 KB |
| stripe-first-donations.md | markdown | 10.7 KB |
| web-manifest-system.md | markdown | 11.9 KB |
| webhook-system.md | markdown | 9.5 KB |
onboarding-and-first-run.md
View on GitHub---
name: "Onboarding and First-Run"
version: "2.0.0"
updated: "2026-04-23"
description: "SaaS onboarding flows: welcome modal, guided tour with tooltips, progress checklist, welcome email, activation tracking via PostHog. Reduces time-to-value for new users. Targets 20-40% activation rate. Use when building SaaS products with user accounts."
---
# Onboarding and First-Run
## When to Include
- Any SaaS product with user accounts
- Any product where users need to configure or learn something
- **NOT needed for** — simple marketing sites, blogs, donation pages
## Onboarding Checklist (In-App)
```html
<div class="onboarding-checklist" data-show-until="complete">
<h3>Get started</h3>
<div class="progress-bar"><div class="fill" style="width: 33%"></div></div>
<ul>
<li class="done">✅ Create your account</li>
<li class="current">⬜ Set up your first [thing]</li>
<li>⬜ Invite a team member</li>
</ul>
</div>
```
### Checklist Logic
```typescript
// Track onboarding steps in D1 or KV
interface OnboardingState {
accountCreated: boolean; // true after signup
firstThingCreated: boolean; // true after key action
teamMemberInvited: boolean; // true after invite
onboardingComplete: boolean; // true when all done
}
// PostHog tracking
posthog.capture('onboarding_step_completed', { step: 'first_thing_created' });
posthog.capture('onboarding_complete', { time_to_complete_ms: elapsed });
```
## Welcome Email (`09/email-templates`)
Sent immediately after signup via Resend:
```
Subject: "Welcome to [Product] 🎉"
Hey [name],
You're in. Here's how to get the most out of [Product]:
1. [First key action] — takes 30 seconds
2. [Second key action] — unlock the full experience
3. [Third key action] — for power users
If you need anything, just reply to this email.
— Brian
```
## Activation Metrics (Source: SaaS benchmarks)
| Metric | Target | Track Via |
|--------|--------|-----------|
| Signup → first action | <60 seconds | PostHog |
| Day 1 retention | >40% | PostHog |
| Day 7 retention | >20% | PostHog |
| Onboarding completion | >60% | PostHog |
| Time to "aha moment" | <5 minutes | PostHog |
## Gamification (Source: Aetherio PLG Research)
- Progress bar showing completion percentage
- Celebratory animation on checklist completion (confetti)
- "3-day streak" badge for daily active use
- Subtle reward for completing each step
## Psychology of Onboarding (`04/wisdom-and-human-psychology` — Wisdom Applied)
### Zeigarnik Effect
- Incomplete tasks stay in memory and create tension
- A progress bar showing "3 of 5 steps complete" drives users to finish
- Never show 100% until they actually complete everything
### Fogg Behavior Model
```
Behavior = Motivation × Ability × Trigger
```
- At onboarding, motivation is at its peak (they just signed up)
- Make the first action extremely easy (high ability)
- Trigger immediately with a clear first step
### Flow State (Csikszentmihalyi)
- Match challenge to skill level
- Start trivially easy, add complexity as users grow
- Immediate feedback on every action
- Minimize distractions during setup
### Give More Than Expected (Matthew 5:41)
- The welcome email should feel like a gift — useful tips, not marketing
- The first experience should over-deliver on the promise that got them to sign up
### Peak-End Rule
- The end of onboarding should be the most delightful moment
- Confetti, a warm message, a clear next step
- This becomes the memory that defines their impression
## Enhancement: 2026 Onboarding Best Practices (Source: NNGroup, Smashing Magazine, YC)
### "Paradox of the Active User" (lawsofux.com)
- Users never read manuals — they start using software immediately
- Design onboarding for hands-on discovery, not documentation
- Tooltips and guided actions beat tutorial videos
### Goal-Gradient Effect Applied
Motivation intensifies near the goal. Structure onboarding so users feel progress early:
- Start at "1 of 3 complete" (account creation counts as step 1)
- Make step 2 trivially easy (<10 seconds)
- Step 3 delivers the "aha moment"
- Never show more than 5 total steps
### COM-B Diagnosis for Onboarding Drop-Off
When users abandon onboarding, diagnose:
- **Capability** — Is the step too complex? (simplify the UI)
- **Opportunity** — Is the environment blocking them? (mobile-unfriendly, slow load)
- **Motivation** — Do they see the value? (show the outcome before asking for effort)
### AI-Native Onboarding (YC 2026)
- Use AI to personalize the first-run experience based on signup context
- Pre-fill forms with intelligent defaults (industry, use case, team size)
- AI-powered "what would you like to do first?" replaces static checklists
- Chatbot assistant available during setup for instant help (but direct answers, not conversation — per NNGroup)
### Anti-Pattern: The "Grand Tour"
Showing users every feature before they need it is the #1 onboarding mistake. Instead:
- Show only what's needed for the first task
- Reveal features progressively as users demonstrate competence
- "Did you know?" tooltips after users complete their first workflow
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |