Retention & Engagement
Scope
Covers
- Diagnosing retention + engagement (cohorts/curves, frequency, segments, drop-offs)
- Identifying the activation / “aha moment” and reducing time-to-value
- Designing habit + re-engagement interventions (daily return, reminders, content loops)
- Creating accruing value and ethical switching costs (“mounting loss”)
- Turning insights into a prioritized experiment + measurement plan
When to use
- “Improve retention / reduce churn”
- “Increase engagement / DAU/WAU”
- “Define our activation / aha moment”
- “D1/D7 retention is low—fix onboarding and time-to-value”
- “Create a retention experiment backlog and a 30/60/90 plan”
When NOT to use
- You don’t have (or can’t assume) a stable value proposition / ICP (use
problem-definition).
- You’re primarily deciding pricing/packaging/paywalls (this skill can add retention context but won’t replace pricing work).
- You need acquisition loop design (use
designing-growth-loops).
- You need to synthesize qualitative churn feedback before proposing experiments (use
analyzing-user-feedback or interviews).
- The problem is specifically first-time onboarding UX (signup flow, empty states, guided setup) rather than full-lifecycle retention (use
user-onboarding).
- You want to apply behavioral science frameworks (habit loops, nudge theory, loss aversion mechanics) as the primary lens rather than a retention metrics lens (use
behavioral-product-design).
- You need to determine whether you have product-market fit before optimizing retention (use
measuring-product-market-fit).
Inputs
Minimum required
- Product + target user/ICP and 1–2 key segments
- Current stage (pre-PMF / early PMF / growth / mature)
- Best-available baseline metrics (even rough):
- retention (D1/D7/D30 or weekly cohort), churn, engagement (DAU/WAU/MAU), activation rate, time-to-value
- Onboarding flow summary (steps/screens + where users drop)
- Constraints: timebox, engineering/design capacity, allowed channels (email/push/in-app), privacy/legal/brand limits
Missing-info strategy
- Ask up to 5 questions from references/INTAKE.md, then proceed.
- If metrics are missing, proceed with explicit assumptions and label confidence.
- Do not request secrets or PII; prefer aggregated metrics and redacted funnels.
Outputs (deliverables)
Produce a Retention & Engagement Improvement Pack (Markdown in-chat; or as files if requested) containing:
- Context snapshot (goal, segments, constraints, timebox)
- Metric definitions + guardrails (how “retention” and “engagement” are measured)
- Retention + engagement diagnosis (cohorts/curves, segments, drop-offs, churn drivers)
- Activation / aha moment definition (candidate behaviors + threshold + validation plan)
- Lever hypotheses map (onboarding → habit → accruing value → re-engagement)
- Experiment backlog (prioritized; experiment cards with success metrics + guardrails)
- Measurement + instrumentation plan (events, dashboards, owners if known)
- 30/60/90 execution plan
- Risks / Open questions / Next steps (always included)
Templates and checklists:
- references/TEMPLATES.md
- references/WORKFLOW.md
- references/CHECKLISTS.md
- references/RUBRIC.md
Workflow (7 steps)
1) Intake + goal framing
- Inputs: User prompt; references/INTAKE.md.
- Actions: Define the retention problem (segment, time horizon, metric) and the decision this work will drive (what will change). Confirm constraints (timebox, capacity, channels, privacy/brand).
- Outputs: Context snapshot + metric definitions draft.
- Checks: Goal is a sentence with a number and a date (e.g., “Improve paid D30 retention from 18%→24% by end of Q2”).
2) Data + instrumentation sanity check
- Inputs: Current tracking/events (or best guess), funnel steps, dashboards (if any).
- Actions: List what you can/can’t measure today. Define the minimum event schema needed to learn (activation, engagement, churn). Identify 1–3 highest-impact instrumentation gaps.
- Outputs: Instrumentation gap list + “minimum viable measurement” plan.
- Checks: Every key metric in the goal has a data source or an explicit assumption.
3) Diagnose: where retention fails (and why)
- Inputs: Baseline metrics, cohorts/curves, funnel drop-offs, segments, any churn feedback.
- Actions: Build a diagnosis across three failure modes:
- Activation failure (users never reach value)
- Engagement decay (users get value once, don’t build a habit)
- Monetization churn (value exists, but price/packaging/friction drives churn)
Segment results (at least 2 segments) and identify the largest “leak.”
- Outputs: Retention + engagement diagnosis table + primary failure mode(s).
- Checks: Diagnosis points to one primary lever to test first (onboarding vs habit vs value vs comms).
4) Define the activation / “aha moment” (data-backed)
- Inputs: Candidate value behaviors + journey; usage events; retention outcome definition.
- Actions: Propose 3–5 candidate “aha” behaviors, then define an activation threshold (e.g., “uses X feature twice within 7 days” or “invites 2 teammates + uses 2 key features within 14 days”). Document how you’ll validate (correlation with D30/D60 retention; holdout if possible).
- Outputs: Activation/aha moment spec + validation plan + tracking requirements.
- Checks: The activation definition is behavioral and measurable (not a survey response or opinion).
5) Generate lever hypotheses (convert insights → rules)
- Inputs: Diagnosis + activation spec; constraints.
- Actions: Create a lever map with hypotheses tied to failure modes:
- Onboarding/time-to-value: get users to aha faster and more reliably
- Habit/daily return: design cues, routines, rewards; reduce friction to “come back tomorrow”
- Accruing value + mounting loss (ethical): personalization, progress/history, saved work, identity/data repository
- Re-engagement: lifecycle messaging, winback, content reminders, in-product nudges
Convert each hypothesis into a rule + check (see references/SOURCE_SUMMARY.md).
- Outputs: Lever hypotheses map + candidate interventions.
- Checks: Every hypothesis ties to (a) a failure mode, and (b) a measurable leading indicator.
6) Design + prioritize experiments (with measurement)
- Inputs: Hypotheses; measurement plan; capacity.
- Actions: Turn top hypotheses into experiment cards (1–2 weeks each). Prioritize using a simple score (Impact × Confidence ÷ Effort). Define success metrics and guardrails; note required instrumentation and rollout/rollback.
- Outputs: Prioritized experiment backlog + experiment cards + metric/guardrail spec.
- Checks: Top 3 experiments are runnable with current constraints and have unambiguous “win/lose/learn” criteria.
7) Build the 30/60/90 plan + quality gate
- Inputs: Draft pack; references/CHECKLISTS.md and references/RUBRIC.md.
- Actions: Sequence work into a 30/60/90 plan (instrumentation, experiments, analysis cadence). Run the checklist and score the rubric. Always include Risks / Open questions / Next steps.
- Outputs: Final Retention & Engagement Improvement Pack.
- Checks: Next 2 weeks of work are unblocked; measurement is in place to learn.
Anti-patterns (common failure modes)
- Vanity-metric retention — Reporting DAU/MAU ratios without segmenting by cohort or user type; masks churn behind new-user influx and leads to false confidence.
- Notification spam as "re-engagement" — Defaulting to push/email frequency increases instead of addressing the underlying value gap; temporarily lifts open rates but accelerates unsubscribes and erodes trust.
- Activation theater — Defining the "aha moment" based on internal opinion ("they saw the dashboard") rather than correlating specific behaviors with downstream retention; produces interventions that move a proxy but not real retention.
- One-size-fits-all diagnosis — Running the same retention playbook for all segments instead of diagnosing distinct failure modes (activation failure vs. engagement decay vs. monetization churn) per segment; wastes experiment capacity on wrong levers.
- Dark-pattern switching costs — Engineering "mounting loss" that traps users (hidden data lock-in, punitive cancellation flows) rather than building genuinely accruing value; creates regulatory risk and brand damage.
Quality gate (required)
- Use references/CHECKLISTS.md and references/RUBRIC.md.
- Always include: Risks, Open questions, Next steps.
Examples
Example 1 (B2C subscription, churn reduction):
“Use retention-engagement. Product: meditation app. Segment: paid subscribers. Baseline: D30 paid retention 22%, churn spikes after week 2. Constraint: 4-week sprint, no major redesign. Output: a Retention & Engagement Improvement Pack with an activation/aha definition, a diagnosis, and a prioritized experiment backlog + 30/60/90 plan.”
Example 2 (B2B SaaS, activation + habit):
“New users activate but don’t return weekly. Define our aha moment, identify the biggest engagement decay point, and propose 5 experiments (in-product + email) with success metrics and guardrails.”
Boundary example (upstream problem):
“Write a brand new value prop and pick an ICP for our product.”
Response: that’s upstream strategy/problem definition; use problem-definition (and optionally PMF measurement) before retention optimization.
Boundary example (onboarding-specific):
“Redesign our signup flow and first-time empty states to reduce drop-off before activation.”
Response: this is first-time onboarding UX, not full-lifecycle retention; use user-onboarding for signup-to-activation flow design. Come back to retention-engagement once users are activated and you need to improve post-activation retention.
Boundary example (growth loop design):
“Design a referral loop so our existing users bring in new users.”
Response: referral/viral loop design is acquisition, not retention; use designing-growth-loops. This skill focuses on keeping existing users engaged and retained, not on building loops that acquire new users.
1---2name: retention-engagement3description: Improve retention and engagement: diagnosis, aha moment, lever hypotheses, experiment backlog. See also: user-onboarding (first-time UX).4---56# Retention & Engagement78## Scope910**Covers**11- Diagnosing retention + engagement (cohorts/curves, frequency, segments, drop-offs)12- Identifying the **activation / “aha moment”** and reducing time-to-value13- Designing habit + re-engagement interventions (daily return, reminders, content loops)14- Creating **accruing value** and ethical **switching costs** (“mounting loss”)15- Turning insights into a prioritized experiment + measurement plan1617**When to use**18- “Improve retention / reduce churn”19- “Increase engagement / DAU/WAU”20- “Define our activation / aha moment”21- “D1/D7 retention is low—fix onboarding and time-to-value”22- “Create a retention experiment backlog and a 30/60/90 plan”2324**When NOT to use**25- You don’t have (or can’t assume) a stable value proposition / ICP (use `problem-definition`).26- You’re primarily deciding pricing/packaging/paywalls (this skill can add retention context but won’t replace pricing work).27- You need acquisition loop design (use `designing-growth-loops`).28- You need to synthesize qualitative churn feedback before proposing experiments (use `analyzing-user-feedback` or interviews).29- The problem is specifically first-time onboarding UX (signup flow, empty states, guided setup) rather than full-lifecycle retention (use `user-onboarding`).30- You want to apply behavioral science frameworks (habit loops, nudge theory, loss aversion mechanics) as the primary lens rather than a retention metrics lens (use `behavioral-product-design`).31- You need to determine whether you have product-market fit before optimizing retention (use `measuring-product-market-fit`).3233## Inputs3435**Minimum required**36- Product + target user/ICP and 1–2 key segments37- Current stage (pre-PMF / early PMF / growth / mature)38- Best-available baseline metrics (even rough):39 - retention (D1/D7/D30 or weekly cohort), churn, engagement (DAU/WAU/MAU), activation rate, time-to-value40- Onboarding flow summary (steps/screens + where users drop)41- Constraints: timebox, engineering/design capacity, allowed channels (email/push/in-app), privacy/legal/brand limits4243**Missing-info strategy**44- Ask up to 5 questions from [references/INTAKE.md](references/INTAKE.md), then proceed.45- If metrics are missing, proceed with explicit assumptions and label confidence.46- Do not request secrets or PII; prefer aggregated metrics and redacted funnels.4748## Outputs (deliverables)4950Produce a **Retention & Engagement Improvement Pack** (Markdown in-chat; or as files if requested) containing:51521) Context snapshot (goal, segments, constraints, timebox)532) Metric definitions + guardrails (how “retention” and “engagement” are measured)543) Retention + engagement diagnosis (cohorts/curves, segments, drop-offs, churn drivers)554) Activation / aha moment definition (candidate behaviors + threshold + validation plan)565) Lever hypotheses map (onboarding → habit → accruing value → re-engagement)576) Experiment backlog (prioritized; experiment cards with success metrics + guardrails)587) Measurement + instrumentation plan (events, dashboards, owners if known)598) 30/60/90 execution plan609) Risks / Open questions / Next steps (always included)6162Templates and checklists:63- [references/TEMPLATES.md](references/TEMPLATES.md)64- [references/WORKFLOW.md](references/WORKFLOW.md)65- [references/CHECKLISTS.md](references/CHECKLISTS.md)66- [references/RUBRIC.md](references/RUBRIC.md)6768## Workflow (7 steps)6970### 1) Intake + goal framing71- **Inputs:** User prompt; [references/INTAKE.md](references/INTAKE.md).72- **Actions:** Define the retention problem (segment, time horizon, metric) and the decision this work will drive (what will change). Confirm constraints (timebox, capacity, channels, privacy/brand).73- **Outputs:** Context snapshot + metric definitions draft.74- **Checks:** Goal is a sentence with a number and a date (e.g., “Improve paid D30 retention from 18%→24% by end of Q2”).7576### 2) Data + instrumentation sanity check77- **Inputs:** Current tracking/events (or best guess), funnel steps, dashboards (if any).78- **Actions:** List what you can/can’t measure today. Define the minimum event schema needed to learn (activation, engagement, churn). Identify 1–3 highest-impact instrumentation gaps.79- **Outputs:** Instrumentation gap list + “minimum viable measurement” plan.80- **Checks:** Every key metric in the goal has a data source or an explicit assumption.8182### 3) Diagnose: where retention fails (and why)83- **Inputs:** Baseline metrics, cohorts/curves, funnel drop-offs, segments, any churn feedback.84- **Actions:** Build a diagnosis across three failure modes:85 - **Activation failure** (users never reach value)86 - **Engagement decay** (users get value once, don’t build a habit)87 - **Monetization churn** (value exists, but price/packaging/friction drives churn)88 Segment results (at least 2 segments) and identify the largest “leak.”89- **Outputs:** Retention + engagement diagnosis table + primary failure mode(s).90- **Checks:** Diagnosis points to one primary lever to test first (onboarding vs habit vs value vs comms).9192### 4) Define the activation / “aha moment” (data-backed)93- **Inputs:** Candidate value behaviors + journey; usage events; retention outcome definition.94- **Actions:** Propose 3–5 candidate “aha” behaviors, then define an activation threshold (e.g., “uses X feature twice within 7 days” or “invites 2 teammates + uses 2 key features within 14 days”). Document how you’ll validate (correlation with D30/D60 retention; holdout if possible).95- **Outputs:** Activation/aha moment spec + validation plan + tracking requirements.96- **Checks:** The activation definition is behavioral and measurable (not a survey response or opinion).9798### 5) Generate lever hypotheses (convert insights → rules)99- **Inputs:** Diagnosis + activation spec; constraints.100- **Actions:** Create a lever map with hypotheses tied to failure modes:101 - **Onboarding/time-to-value:** get users to aha faster and more reliably102 - **Habit/daily return:** design cues, routines, rewards; reduce friction to “come back tomorrow”103 - **Accruing value + mounting loss (ethical):** personalization, progress/history, saved work, identity/data repository104 - **Re-engagement:** lifecycle messaging, winback, content reminders, in-product nudges105 Convert each hypothesis into a rule + check (see [references/SOURCE_SUMMARY.md](references/SOURCE_SUMMARY.md)).106- **Outputs:** Lever hypotheses map + candidate interventions.107- **Checks:** Every hypothesis ties to (a) a failure mode, and (b) a measurable leading indicator.108109### 6) Design + prioritize experiments (with measurement)110- **Inputs:** Hypotheses; measurement plan; capacity.111- **Actions:** Turn top hypotheses into experiment cards (1–2 weeks each). Prioritize using a simple score (Impact × Confidence ÷ Effort). Define success metrics and guardrails; note required instrumentation and rollout/rollback.112- **Outputs:** Prioritized experiment backlog + experiment cards + metric/guardrail spec.113- **Checks:** Top 3 experiments are runnable with current constraints and have unambiguous “win/lose/learn” criteria.114115### 7) Build the 30/60/90 plan + quality gate116- **Inputs:** Draft pack; [references/CHECKLISTS.md](references/CHECKLISTS.md) and [references/RUBRIC.md](references/RUBRIC.md).117- **Actions:** Sequence work into a 30/60/90 plan (instrumentation, experiments, analysis cadence). Run the checklist and score the rubric. Always include **Risks / Open questions / Next steps**.118- **Outputs:** Final Retention & Engagement Improvement Pack.119- **Checks:** Next 2 weeks of work are unblocked; measurement is in place to learn.120121## Anti-patterns (common failure modes)1221231. **Vanity-metric retention** — Reporting DAU/MAU ratios without segmenting by cohort or user type; masks churn behind new-user influx and leads to false confidence.1242. **Notification spam as "re-engagement"** — Defaulting to push/email frequency increases instead of addressing the underlying value gap; temporarily lifts open rates but accelerates unsubscribes and erodes trust.1253. **Activation theater** — Defining the "aha moment" based on internal opinion ("they saw the dashboard") rather than correlating specific behaviors with downstream retention; produces interventions that move a proxy but not real retention.1264. **One-size-fits-all diagnosis** — Running the same retention playbook for all segments instead of diagnosing distinct failure modes (activation failure vs. engagement decay vs. monetization churn) per segment; wastes experiment capacity on wrong levers.1275. **Dark-pattern switching costs** — Engineering "mounting loss" that traps users (hidden data lock-in, punitive cancellation flows) rather than building genuinely accruing value; creates regulatory risk and brand damage.128129## Quality gate (required)130- Use [references/CHECKLISTS.md](references/CHECKLISTS.md) and [references/RUBRIC.md](references/RUBRIC.md).131- Always include: **Risks**, **Open questions**, **Next steps**.132133## Examples134135**Example 1 (B2C subscription, churn reduction):** 136“Use `retention-engagement`. Product: meditation app. Segment: paid subscribers. Baseline: D30 paid retention 22%, churn spikes after week 2. Constraint: 4-week sprint, no major redesign. Output: a Retention & Engagement Improvement Pack with an activation/aha definition, a diagnosis, and a prioritized experiment backlog + 30/60/90 plan.”137138**Example 2 (B2B SaaS, activation + habit):** 139“New users activate but don’t return weekly. Define our aha moment, identify the biggest engagement decay point, and propose 5 experiments (in-product + email) with success metrics and guardrails.”140141**Boundary example (upstream problem):**142“Write a brand new value prop and pick an ICP for our product.”143Response: that’s upstream strategy/problem definition; use `problem-definition` (and optionally PMF measurement) before retention optimization.144145**Boundary example (onboarding-specific):**146“Redesign our signup flow and first-time empty states to reduce drop-off before activation.”147Response: this is first-time onboarding UX, not full-lifecycle retention; use `user-onboarding` for signup-to-activation flow design. Come back to `retention-engagement` once users are activated and you need to improve post-activation retention.148149**Boundary example (growth loop design):**150“Design a referral loop so our existing users bring in new users.”151Response: referral/viral loop design is acquisition, not retention; use `designing-growth-loops`. This skill focuses on keeping existing users engaged and retained, not on building loops that acquire new users.152