lifecycle-marketing-automation
Map customer journey stages from first visit to loyal advocate with personalized messaging, triggered workflows, and segment-based campaign automation
Best use case
lifecycle-marketing-automation is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Map customer journey stages from first visit to loyal advocate with personalized messaging, triggered workflows, and segment-based campaign automation
Teams using lifecycle-marketing-automation should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/lifecycle-marketing-automation/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How lifecycle-marketing-automation Compares
| Feature / Agent | lifecycle-marketing-automation | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Map customer journey stages from first visit to loyal advocate with personalized messaging, triggered workflows, and segment-based campaign automation
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Lifecycle Marketing Automation
## Overview
Lifecycle marketing treats each customer as being at a defined stage in their relationship with your brand — from anonymous visitor to loyal advocate — and delivers stage-appropriate messaging automatically. Unlike broadcast campaigns, lifecycle automation is triggered by behavior and stage transitions, ensuring every message is relevant. Klaviyo's predictive analytics and flow builder cover most lifecycle automation needs without custom code.
## When to Use This Skill
- When moving from batch-and-blast campaigns to behavior-triggered messaging
- When different customer segments are receiving identical generic emails
- When onboarding new customers and needing a structured first-30-day nurture plan
- When LTV and repeat purchase rate are flat despite healthy acquisition numbers
- When building a holistic view of the customer journey across email, SMS, and push
## Core Instructions
### Step 1: Define your lifecycle stages
| Stage | Definition | Primary Goal |
|-------|-----------|-------------|
| **Subscriber** | Email captured, no purchase | Convert to first purchase |
| **First-time buyer** | 1 order, placed < 60 days ago | Onboard, reduce returns, build habit |
| **Active** | 2+ orders, purchased within repurchase window | Grow AOV and purchase frequency |
| **Loyal** | 4+ orders OR > $500 LTV | Maintain, protect from churn, reward |
| **At-risk** | Approaching 1.5x their normal repurchase window | Proactive re-engagement |
| **Lapsed** | Beyond 2x their normal repurchase window | Win-back campaign |
| **Advocate** | Has reviewed, referred, or engaged heavily | Amplify via referral program |
### Step 2: Set up lifecycle automation per stage
---
#### Shopify with Klaviyo
Klaviyo computes expected repurchase dates and churn risk automatically based on your order history — you do not need to calculate lifecycle stages manually.
**Subscriber stage — Welcome Series:**
1. Go to **Klaviyo → Flows → Create Flow → Welcome Series** (use template)
2. The flow fires when someone joins your email list
3. Configure 3 emails over 7 days:
- Email 1 (immediate): Welcome + brand story + first-order discount
- Email 2 (day 2): Bestsellers or "Start here" product guide
- Email 3 (day 7): Social proof (reviews, customer photos, media mentions)
4. Add a **flow filter**: "Has NOT placed an order" — exits the flow if they purchase before completing it
**First-time buyer stage — Post-Purchase Onboarding:**
1. Create a new flow: trigger = **Placed Order**, filter = "First order ever" (Klaviyo's "First order" conditional)
2. Configure 3 emails:
- Email 1 (day 2): Product usage tips or setup guide
- Email 2 (day 7): Cross-sell recommendations based on purchased product
- Email 3 (day 21): Review request
3. This flow is separate from the standard post-purchase flow to give first-timers extra attention
**Loyal stage — VIP Recognition:**
1. Create a segment: `Total Customer Value > $500` OR `Total Order Count >= 4`
2. Create a flow triggered by **Segment Entry** for this segment
3. Send a single "You've unlocked VIP status" email with exclusive benefits (early access, free shipping, loyalty points bonus)
4. Add these customers to a **Klaviyo List** called "VIP" and use it as a segment for early access campaigns
**At-risk stage — Retention Nudge:**
1. Create a segment using Klaviyo's predictive analytics: `Predicted Churn Risk = High OR Mid`
2. Create a flow triggered by **Segment Entry**:
- Email 1 (immediate): Personalized "We miss you" with product recommendations based on past purchases
- Wait 5 days → Email 2: New arrivals or "What's changed since your last visit"
- Wait 5 days → Email 3 (only for customers with > $200 LTV): 15% off exclusive offer
**Lapsed stage → Win-Back:**
- See @win-back-reactivation for the full win-back campaign setup
---
#### WooCommerce with AutomateWoo
1. Install **AutomateWoo** ($99/yr) from the WooCommerce marketplace
2. Build individual workflows for each stage transition:
**Welcome Series:**
- Trigger: **Subscribe → Newsletter** (with your email plugin) or **Customer → Created** (new account)
- Add 3 email actions with timing delays
**Post-purchase onboarding:**
- Trigger: **Order → Status Changed to Completed**
- Add condition: **Customer order count equals 1** (first-time buyer)
- Configure email sequence with delays
**At-risk re-engagement:**
- Trigger: **Customer → Win Back** (built-in AutomateWoo trigger)
- Set "No order in last" to 1.5x your average repurchase cycle
- Create escalating emails: reminder → offer
AutomateWoo's built-in **RFM Analysis** (go to **AutomateWoo → Reports → RFM Analysis**) shows your customers on an RFM grid — use this to identify which customers to target with each lifecycle stage campaign.
---
#### BigCommerce
1. Install **Klaviyo** from the BigCommerce App Marketplace
2. Klaviyo syncs all BigCommerce order history automatically
3. Follow the same Klaviyo flow setup as the Shopify section above
---
#### Custom / Headless
Send lifecycle events to Klaviyo's API:
```typescript
// Update customer's lifecycle stage as a Klaviyo profile property
async function updateLifecycleStage(email: string, stage: string) {
await fetch('https://a.klaviyo.com/api/profile-import/', {
method: 'POST',
headers: {
'Authorization': `Klaviyo-API-Key ${process.env.KLAVIYO_PRIVATE_KEY}`,
'Content-Type': 'application/json',
'revision': '2024-10-15',
},
body: JSON.stringify({
data: {
type: 'profile',
attributes: {
email,
properties: {
lifecycle_stage: stage,
lifecycle_stage_updated_at: new Date().toISOString(),
},
},
},
}),
});
}
// Call this on key events:
// After first purchase: updateLifecycleStage(email, 'first-time-buyer')
// After 4th purchase or $500 LTV: updateLifecycleStage(email, 'loyal')
// When churn risk detected: updateLifecycleStage(email, 'at-risk')
```
Then in Klaviyo, create flows triggered by **Profile Property Changed → lifecycle_stage equals [stage]**.
### Step 3: Configure stage-appropriate messaging
| Stage | Channel | Frequency | Content Focus | Incentive |
|-------|---------|-----------|--------------|-----------|
| Subscriber | Email | Weekly | Brand education, social proof | First-order discount |
| First-time buyer | Email | Triggered only | Product onboarding, care tips | No discount — build value |
| Active | Email | Biweekly | New arrivals, cross-sell | None (they are buying) |
| Loyal | Email | Weekly | Exclusive access, new drops | Early access, not discounts |
| At-risk | Email + SMS | Triggered only | Re-engagement, recommendations | Small offer for high-LTV only |
| Advocate | Email | Biweekly | Referral program, exclusives | Referral bonuses |
### Step 4: Measure lifecycle health
Track these in Klaviyo or your analytics dashboard:
| Metric | Target | Where to Find |
|--------|--------|---------------|
| Subscriber → first purchase conversion | > 10% within 30 days | Klaviyo → Welcome series flow analytics |
| First-time buyer repeat purchase rate | > 30% within 90 days | Shopify: Analytics → Customer cohorts |
| At-risk customers saved | > 20% convert after retention flow | Klaviyo → Segment size change over time |
| Loyal customer share of revenue | > 40% of total revenue | Klaviyo → VIP segment campaign analytics |
## Best Practices
- **Cancel competing flows on conversion** — in Klaviyo, add a flow filter to every win-back and retention flow: "Has placed order since starting flow → exit"; prevents irrelevant messages after purchase
- **Always cancel retention flows when a customer purchases** — set up a Klaviyo flow that triggers on "Placed Order" and uses a Trigger Split to exit the person from any active retention flows
- **Use Klaviyo's predictive analytics** — do not manually calculate lifecycle stages; Klaviyo's expected next purchase date and churn risk are more accurate than manual rules
- **Personalize with dynamic product blocks** — every retention and win-back email should show products based on what the customer has bought before, not generic bestsellers
- **Keep stage definitions simple** — 5–7 stages is enough; adding more stages creates messaging overlap and complexity without proportional benefit
## Common Pitfalls
| Problem | Solution |
|---------|----------|
| Customers receive win-back email after just buying | Add flow filter "Has placed order in last 7 days → exit" and verify the Placed Order event is firing in Klaviyo |
| All customers stuck in "subscriber" stage | Check that Placed Order events are syncing from Shopify to Klaviyo; verify integration is active under Klaviyo → Integrations |
| Loyal customers receiving lapsed messaging | Segment filters in Klaviyo run at entry time; add re-evaluation by using **Flow Filters** that check current lifetime value before each send |
| Welcome series and post-purchase flow both send to new buyers | Add a flow filter to the Welcome Series: "Has NOT placed an order" — this exits them from Welcome when they buy |
## Related Skills
- @customer-retention-engine
- @email-marketing-automation
- @win-back-reactivation
- @loyalty-program-optimization
- @email-list-segmentationRelated Skills
tax-compliance-automation
Automate multi-jurisdiction sales tax, VAT, and GST compliance with nexus tracking, exemption certificates, filing automation, and audit-ready reports
payment-reconciliation-automation
Automate payment reconciliation across Stripe, PayPal, and bank accounts with exception handling, automated matching rules, and discrepancy alerting
invoice-generation-automation
Generate professional invoices automatically with custom branding, payment terms, line item details, tax breakdowns, and integration with accounting systems
accounts-receivable-automation
Automate B2B accounts receivable with invoice generation, payment tracking, dunning sequences for past-due invoices, and aging analysis dashboards
sms-marketing
Launch SMS marketing campaigns with opt-in flows, audience segmentation, and full TCPA/GDPR compliance to drive revenue through text messaging
seasonal-campaign-automation
Automate seasonal marketing campaigns for Black Friday, holidays, and shopping events with templated workflows, countdown sequences, and year-round planning
marketing-attribution-dashboard
Build multi-touch attribution dashboards tracking revenue by channel, campaign, and creative with blended ROAS analysis and budget allocation recommendations
email-marketing-automation
Build automated email flows for welcome series, post-purchase follow-ups, win-back campaigns, and browse abandonment to drive repeat revenue
marketing-spend-analysis
Track and analyze marketing spend across all channels with ROAS calculation, diminishing returns analysis, and budget reallocation recommendations by platform
wishlist-save-for-later
Let shoppers save products to a wishlist, share it with friends, and get notified when saved items come back in stock or drop in price
storefront-theming
Build a themeable storefront with design tokens and CSS custom properties that supports white-labeling, multi-brand variants, and dark mode
search-autocomplete
Speed up product discovery with instant search suggestions, fuzzy typo matching, and category-aware results powered by Algolia or Elasticsearch