Skill: leooooooow/aes-customer-onboarding (version 1.1.0)

--- name: Customer Onboarding description: Design post-first-purchase onboarding sequences that educate customers, reduce returns, and drive repeat orders. --- # Customer Onboarding Designing the right post-purchase experience is one of the highest-leverage activities for any ecommerce brand. Customer Onboarding helps you build structured onboarding sequences that guide first-time buyers from order confirmation through product adoption, turning one-time purchasers into loyal repeat customers while simultaneously reducing return rates. This skill provides a comprehensive framework for mapping every touchpoint in the post-purchase journey. It analyzes your product type, customer profile, and existing communications to generate a complete onboarding playbook with specific timing, channel selection, content direction, and measurable KPIs for each message in the sequence. ## Quick Reference | Decision | Strong | Acceptable | Weak | |----------|--------|------------|------| | Sequence length | 6-8 touchpoints over 30 days tied to delivery milestones | 4-5 generic messages on fixed schedule | Single welcome email with no follow-up | | Channel mix | Multi-channel (email + SMS + in-package insert + push) matched to message urgency | Email-only with SMS for shipping updates | Single channel for all communications | | Timing triggers | Event-based (delivered, opened, used, reviewed) with fallback windows | Time-based from purchase date with some event triggers | Fixed calendar dates regardless of delivery status | | Content depth | Product-specific education with usage tips, care guides, and styling/pairing suggestions | Generic brand story with basic product info | Order confirmation only with no educational content | | Personalization level | Segment by product category, purchase history, and acquisition channel | Segment by new vs. returning customer | Same sequence for all customers regardless of context | | Success metrics | Track per-touchpoint engagement plus 30/60/90 day repurchase and return rates | Track overall sequence open and click rates | No measurement beyond delivery confirmation | ## Solves - **High return rates from product misunderstanding**: Customers return items because they don't know how to use, style, or maintain them. Proactive education within the first 7 days post-delivery dramatically reduces "not what I expected" returns. - **Low repeat purchase rates**: First-time buyers never come back because there's no structured path from first purchase to second. A well-timed cross-sell sequence within the 30-day adoption window captures the highest-intent repurchase moment. - **Poor product adoption and satisfaction**: Complex or multi-step products (skincare routines, tech gadgets, specialty food) need guided onboarding or customers abandon them. Step-by-step education emails increase product usage and satisfaction scores. - **Missing post-purchase communication strategy**: Many brands stop communicating after shipping confirmation, leaving a critical relationship-building window empty. This skill fills the gap with a complete touchpoint map. - **Inconsistent brand experience across channels**: Order confirmation comes from Shopify, shipping from the carrier, and marketing from Klaviyo with no cohesive narrative. This skill unifies all post-purchase communications into a single branded journey. - **No review or UGC generation system**: Brands struggle to get reviews because they ask at the wrong time or in the wrong way. The skill places review requests at the optimal moment after product adoption, not just delivery. - **Wasted cross-sell and upsell opportunities**: Related product recommendations sent too early (before the customer has even tried the first product) or too late (after the adoption window closes) miss the mark. The skill times commercial messages to the product adoption curve. ## Workflow ### Step 1 — Gather product and customer context Collect the essential inputs that shape the onboarding sequence. You need to understand the product category, typical customer profile, average delivery timeline, and any existing post-purchase communications already in place. **Key questions to answer:** - What is the product type and complexity level? (Simple consumable vs. multi-step routine vs. technical device) - What is the typical customer profile? (Age range, tech savviness, primary purchase motivation) - What is the average shipping time from order to delivery? - What channels are currently available? (Email platform, SMS provider, push notification capability, in-package insert feasibility) - What post-purchase emails or messages already exist? - What are the current return rate, repurchase rate, and average days between first and second purchase? ### Step 2 — Map the delivery timeline and milestone triggers Build the event-based timeline that anchors every touchpoint. Instead of fixed calendar dates, tie messages to real customer milestones: order placed, shipped, out for delivery, delivered, first use (estimated), adoption checkpoint, review window, and repurchase window. **Timeline framework:** - Day 0: Order confirmation (immediate) - Day 1-2: Order processing / brand story - Day 3-7: Shipping notification + what to expect - Delivery day: Delivery confirmation + unboxing guide - Day 1-3 post-delivery: Product education / setup guide - Day 5-7 post-delivery: Usage tips / advanced features - Day 10-14 post-delivery: Check-in + review request - Day 21-30 post-delivery: Cross-sell / repurchase prompt ### Step 3 — Design content for each touchpoint For each message in the sequence, define the channel, subject/headline, content framework, primary CTA, and success metric. Every message should have a clear educational or relationship-building purpose — not just promotional content. **Content principles:** - Lead with value (education, tips, inspiration) before any commercial ask - Match content depth to product complexity - Use progressive disclosure — don't overwhelm in the first message - Include visual elements (product photos, how-to images, user-generated content) - Personalize based on specific product purchased, not generic brand content ### Step 4 — Build the channel strategy Assign each touchpoint to the optimal channel based on message urgency, content type, and customer preference. High-urgency transactional messages (shipping, delivery) use SMS or push. Educational content uses email for depth. Quick tips can use SMS for immediacy. **Channel selection matrix:** - Email: Best for rich content, product education, visual storytelling, and cross-sell recommendations - SMS: Best for time-sensitive updates (shipping, delivery), quick tips, and urgent CTAs (flash sales, limited stock) - Push notifications: Best for app-based brands, gentle reminders, and engagement nudges - In-package inserts: Best for setup guides, QR codes to video tutorials, and loyalty program enrollment ### Step 5 — Set up tracking and metrics Define the KPIs for each touchpoint and the overall sequence. Individual message metrics (open rate, click rate, conversion) help optimize content, while sequence-level metrics (30-day repurchase rate, return rate, NPS) measure business impact. **Key metrics per touchpoint:** - Open rate (email) or delivery rate (SMS) - Click-through rate to target content - Specific action completion (setup guide viewed, review submitted, second purchase made) **Sequence-level metrics:** - 30-day repurchase rate for onboarded customers vs. control - Return rate for onboarded customers vs. control - Customer satisfaction score (CSAT) or Net Promoter Score (NPS) - Average days to second purchase - Review submission rate ### Step 6 — Create A/B testing roadmap Plan systematic tests to optimize each touchpoint over the first 90 days. Prioritize tests by expected impact: subject lines and send times first, then content variations, then channel experiments. **Testing priorities:** 1. Subject line variations for the highest-volume messages 2. Send time optimization based on open rate data 3. Content format testing (text vs. visual, long vs. short) 4. CTA placement and copy testing 5. Channel substitution tests (email vs. SMS for specific touchpoints) ### Step 7 — Document the complete playbook Compile everything into a structured onboarding playbook that can be handed to the email/SMS team for implementation. Include the sequence timeline, content briefs for each message, channel assignments, metric targets, and the testing roadmap. ## Example 1 — Premium Skincare Brand (Multi-Step Routine) **Context:** A DTC skincare brand selling a 3-step routine (cleanser, serum, moisturizer) at $89 average order value. Average delivery time is 4 days. Current return rate is 18% with "didn't work for my skin" as the top reason. Repeat purchase rate is 22% at 60 days. **Product complexity:** High — requires correct application order, amount, and frequency for results. **Onboarding sequence:** | Day | Channel | Message | Content Focus | CTA | |-----|---------|---------|---------------|-----| | 0 | Email | Order confirmed — your skin transformation starts soon | Set expectations: results timeline (2-4 weeks), what to expect during adjustment period | Read the Getting Started guide | | 0 | SMS | Thanks for your order! We'll text you when it ships 💫 | Opt-in confirmation for SMS updates | Reply YES to confirm | | 3 | Email | Your routine is on its way | Prep content: how to patch test, best time to start new routine, what to stop using | Watch the 2-min setup video | | 4 | SMS | Your skincare routine just delivered! 📦 | Delivery alert with excitement | Open your unboxing guide | | 5 | Email | Night 1: Let's start your routine together | Step-by-step first application guide with photos, amounts (pea-size, dime-size), and order | Follow along tonight | | 8 | Email | How's your skin feeling? (This is normal) | Address common Day 3-5 concerns: slight tingling, adjustment period, purging vs. breakout | Take your Day 3 skin selfie | | 12 | SMS | Quick tip: apply serum to damp skin for 2x absorption ✨ | Single actionable tip to improve results | | | 18 | Email | Week 2 check-in: your skin is adapting | Progress encouragement, introduce advanced tips (layering, mixing), share before/after from other customers | Share your progress | | 25 | Email | See what others are saying about their results | Social proof: reviews, UGC photos, testimonials from similar skin types | Leave your review | | 32 | Email | Your routine essentials: time to restock? | Repurchase reminder based on typical usage rate, introduce complementary products (SPF, eye cream) | Restock and save 15% | **Expected outcomes:** Return rate reduction to 11% (from 18%), repurchase rate increase to 35% (from 22%), review submission rate of 12%. ## Example 2 — Home Fitness Equipment (Single Complex Product) **Context:** A brand selling a smart resistance band system at $149. Average delivery time is 6 days. Product requires app download, Bluetooth pairing, and workout selection. Current return rate is 24% — mostly "too complicated" or "didn't use it." 90-day repurchase rate for accessories is 8%. **Product complexity:** High — hardware setup, app onboarding, and behavior change required. **Onboarding sequence:** | Day | Channel | Message | Content Focus | CTA | |-----|---------|---------|---------------|-----| | 0 | Email | Order confirmed — your home gym is coming | Set expectations: what's in the box, pre-download the app, clear space for workouts | Download the app now | | 0 | Push | Welcome! Download the app to get ready 💪 | App install prompt with direct link | Install app | | 5 | SMS | Your resistance band system is arriving today! | Delivery alert | Watch the 90-second setup video | | 5 | Email | Unboxing guide: set up in under 5 minutes | Step-by-step visual setup guide: unpack, charge, pair Bluetooth, first calibration | Start setup now | | 6 | Push | Ready for your first workout? Try the 10-min starter routine | Low-commitment first workout to build habit | Start workout | | 8 | Email | 3 beginner workouts picked for you | Curated beginner content based on fitness goal selected in app | Pick your workout | | 11 | SMS | You've completed 2 workouts! 🎉 Keep the streak going | Progress celebration and habit reinforcement | Open today's workout | | 15 | Email | Level up: unlock intermediate routines | Progressive difficulty introduction, feature discovery (tracking, challenges, social) | Explore new workouts | | 22 | Email | Your first 3 weeks: here's your progress | Data summary: workouts completed, total minutes, estimated calories, strength progress | Share your stats | | 22 | SMS | Love your results? Tell us in 30 seconds | Review request timed to progress milestone | Leave a quick review | | 35 | Email | Upgrade your setup: bands + anchor accessories | Cross-sell accessories based on workout types completed | Shop accessories — 20% off | **Expected outcomes:** Return rate reduction to 14% (from 24%), app activation rate 78% (from 45%), accessory purchase rate 18% (from 8%). ## Common Mistakes 1. **Sending the review request too early**: Asking for a review on delivery day or the day after means the customer hasn't actually used the product yet. Their review will be about packaging and shipping speed, not product quality. Wait until Day 10-14 post-delivery when they've had meaningful experience with the product. 2. **Treating all products the same**: A $15 consumable and a $200 tech device need fundamentally different onboarding depth and timing. Simple products need 3-4 touches focused on reorder timing. Complex products need 7-8 touches focused on education and adoption. Match sequence length to product complexity. 3. **Leading with promotions instead of value**: Starting the post-purchase sequence with discount codes and cross-sell pushes signals that you only care about the next sale. Lead with education, tips, and genuine helpfulness for the first 14 days. Commercial messages should come after the customer has adopted the product. 4. **Ignoring the delivery gap**: The 3-7 days between order and delivery is dead air for most brands. This is prime time for expectation-setting content: what to expect, how to prepare, the story behind the product. Brands that fill this gap see 23% higher post-delivery email engagement. 5. **Using fixed schedules instead of event triggers**: Sending "Day 3: Your product guide" when the product hasn't arrived yet (delayed shipping) destroys credibility. Always tie educational content to delivery confirmation, not order date. Use delivery webhooks from your shipping provider. 6. **Forgetting mobile optimization**: Over 70% of post-purchase emails are opened on mobile, yet brands send desktop-formatted messages with tiny text and wide images. Every onboarding email must be mobile-first: single-column layout, large tap targets, concise copy, and optimized images. 7. **No segmentation by acquisition channel**: A customer acquired through TikTok expects a different communication style than one from Google Search. TikTok buyers respond better to video content, casual tone, and social proof. Search buyers respond better to detailed specifications, comparison content, and expert reviews. 8. **Skipping the in-package insert**: Physical touchpoints have near-100% visibility — everyone opens their package. A well-designed insert with a QR code linking to a setup video or exclusive content bridges the physical-digital gap and drives app downloads or account creation. 9. **Not measuring the right metrics**: Tracking only email open rates misses the business impact. The metrics that matter are 30-day repurchase rate, return rate reduction, product activation rate, and customer lifetime value for onboarded vs. non-onboarded cohorts. Set up proper attribution before launching. 10. **Ending the sequence too abruptly**: Going from helpful onboarding emails to sudden silence (or worse, jumping straight into promotional blasts) creates whiplash. Transition gradually from onboarding to ongoing lifecycle marketing with a bridge message that sets expectations for future communications. ## Resources For detailed implementation guidance, refer to these companion files: - **[references/output-template.md](references/output-template.md)**: Structured template for the complete onboarding playbook deliverable - **[references/onboarding-sequence-guide.md](references/onboarding-sequence-guide.md)**: Deep-dive guide on sequence design principles, timing psychology, and channel selection frameworks - **[references/channel-timing-reference.md](references/channel-timing-reference.md)**: Reference card for optimal send times, channel selection by message type, and frequency caps by customer segment - **[assets/quality-checklist.md](assets/quality-checklist.md)**: Pre-launch quality checklist covering content, timing, technical setup, personalization, and compliance requirements


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal:  | SkillSpector: clean (LOW)