Behavior Design Framework
Unverified●25/40Claude Code◐PartialHas SKILL.md but declares no allowed-tools — Claude Code will ask for permission each time
Cursor◐PartialPlain prose you can paste in — but no Cursor rules file
Codex◐PartialPlain prose you can paste in — but no AGENTS.md
Gemini CLI◐PartialPlain prose you can paste in
Copilot◐PartialPlain prose you can paste in — but no Copilot instructions file
npx agentalley add improve-retentionWho is stuck, and on what
People try my thing once and then just disappear. I don't know if it's because it's too much hassle, I'm nagging them wrong, or they just forget about it.
What it gives you
A step-by-step plan that pinpoints why people stop and gives you specific changes to the steps, reminders, and rewards so the habit sticks.
When NOT to use it
It won't build the app, send the messages, or run anything for you — it hands you the plan, you make the changes.
The whole source
Frontmatter — 4 properties
| name | improve-retention |
|---|---|
| description | Diagnose and fix retention problems using behavior design (B=MAP). Use when the user mentions "users sign up but dont stick around", "activation rate", "onboarding friction", "retention metrics", "why users dont complete", "churn analysis", or "aha moment". Also trigger when analyzing cohort retention curves, designing activation milestones, reducing time-to-value for new users, or investigating why users quit after their first session. Covers the Ability Chain, prompt design, and tiny behaviors that compound. For habit loops and variable rewards, see hooked-ux. For intrinsic motivation, see drive-motivation. |
| license | MIT |
| metadata | author: wondelai version: "1.4.0 |
| 1 | --- |
| 2 | name: improve-retention |
| 3 | description: 'Diagnose and fix retention problems using behavior design (B=MAP). Use when the user mentions "users sign up but dont stick around", "activation rate", "onboarding friction", "retention metrics", "why users dont complete", "churn analysis", or "aha moment". Also trigger when analyzing cohort retention curves, designing activation milestones, reducing time-to-value for new users, or investigating why users quit after their first session. Covers the Ability Chain, prompt design, and tiny behaviors that compound. For habit loops and variable rewards, see hooked-ux. For intrinsic motivation, see drive-motivation.'B1 — Line is 631 characters — unreadable by eye |
| 4 | license: MIT |
| 5 | metadata: |
| 6 | author: wondelai |
| 7 | version: "1.4.0" |
| 8 | ---A5 — No allowed-tools declared — no way to tell what this skill may touch |
| 9 | |
| 10 | # Behavior Design Framework |
| 11 | |
| 12 | Framework for designing products that reliably change behavior. Behavior is not about willpower or motivation — it is a design problem with a predictable equation. |
| 13 | |
| 14 | ## Core Principle |
| 15 | |
| 16 | **The Fogg Behavior Model** = B=MAP. Behavior happens when Motivation, Ability, and a Prompt converge at the same moment. |
| 17 | |
| 18 | ``` |
| 19 | HIGH ┃ |
| 20 | ┃ ★ Behavior happens |
| 21 | ┃ (above the Action Line) |
| 22 | ┃ |
| 23 | Motivation ┃━━━━━━━━━━━━━━━━━━━━━━━ ← Action Line |
| 24 | ┃ |
| 25 | ┃ ✗ Behavior fails |
| 26 | ┃ (below the Action Line) |
| 27 | LOW ┃ |
| 28 | ┗━━━━━━━━━━━━━━━━━━━━━━━━━ |
| 29 | HARD EASY |
| 30 | Ability |
| 31 | ``` |
| 32 | |
| 33 | **The Action Line:** When motivation and ability are sufficient, a prompt causes the behavior; below the line, no prompt works. High motivation compensates for low ability and vice versa. The reliable strategy is making behaviors easier (move right), not pumping up motivation (move up). |
| 34 | |
| 35 | See: [references/behavior-model.md](references/behavior-model.md) when you need the curve mechanics behind this model — the full Action Line math, behavior types (dot/span/path), and a step-by-step failure diagnostic for a behavior that isn't happening. |
| 36 | |
| 37 | ## Scoring |
| 38 | |
| 39 | **Goal: 10/10.** The six Quick Diagnostic rows are the single source of score-movers. Rate each pass/fail, then start at 10 and subtract per failing row: low motivation or below the Action Line (rows 1-2) cost **-2** each; prompts, celebration, bottleneck, and scaling (rows 3-6) cost **-1.5** each. A design that passes all six scores 10; one that fails every row scores 0. Map to bands: **9-10** = behavior reliably crosses the Action Line at low motivation, prompts are event/anchor-tied, key actions are celebrated; **5-6** = depends on a motivation spike or optimizes a non-bottleneck factor; **<=3** = core action below the Action Line, prompts are spam, no habit wiring. Always state the score and name the specific failing rows.B1 — Line is 736 characters — unreadable by eye |
| 40 | |
| 41 | ## The Three Elements |
| 42 | |
| 43 | ### 1. Motivation |
| 44 | |
| 45 | **Core concept:** Motivation is the energy for action, driven by three core motivators, each with two sides: Sensation (pleasure/pain), Anticipation (hope/fear), Belonging (acceptance/rejection). It is powerful but unreliable. |
| 46 | |
| 47 | **Why it works:** Motivation comes in waves — it spikes (New Year's resolutions, product launches) and crashes (day 3, week 2). Products that depend on high motivation fail when the wave recedes; the best designs work at the trough. |
| 48 | |
| 49 | **Key insights:** |
| 50 | - "Motivation is unreliable. Ability is not." — BJ Fogg |
| 51 | - Design for low-motivation moments, not peak excitement |
| 52 | - Motivation-first tactics (inspiring videos, aspirational messaging) produce spikes, not sustained behavior |
| 53 | - Match required motivation to behavior difficulty — hard behaviors need high motivation |
| 54 | |
| 55 | **Product applications:** |
| 56 | |
| 57 | | Context | Application | Example | |
| 58 | |---------|-------------|---------| |
| 59 | | **Onboarding** | Don't count on the new-user spike lasting | First actions work even when excitement fades | |
| 60 | | **Re-engagement** | Assume returning users have low motivation | Show immediate value before asking for effort | |
| 61 | | **Messaging** | Tap the right motivator | Social fitness → belonging; financial tool → hope | |
| 62 | |
| 63 | **Copy patterns:** |
| 64 | - "Takes 30 seconds" (signals ease, lowers motivation needed) |
| 65 | - "Join 50,000 teams who..." (belonging motivator) |
| 66 | - "Don't lose your 7-day streak" (anticipation/fear motivator) |
| 67 | |
| 68 | **Ethical boundary:** A fear motivator (the streak pattern above) is fair only when the loss is real and user-owned (their data, their progress); never invent a loss that exists solely to drive a session. |
| 69 | |
| 70 | See: [references/motivation-waves.md](references/motivation-waves.md) for the three motivators, motivation waves, and designing for troughs. |
| 71 | |
| 72 | ### 2. Ability |
| 73 | |
| 74 | **Core concept:** Ability is the capacity to do the behavior — a function of the scarcest resource across six factors (the Ability Chain). If any single link is too weak, the behavior breaks. |
| 75 | |
| 76 | **Why it works:** Unlike motivation, ability can be systematically engineered: every removed field, eliminated step, and preset default moves the behavior right on the model, crossing the Action Line even at low motivation. The Ability Chain gives you the diagnostic — find the weakest link and fix it. |
| 77 | |
| 78 | **Key insights:** |
| 79 | - Six factors: Time, Money, Physical Effort, Mental Effort, Social Deviance, Non-Routine |
| 80 | - Simplicity is a function of the scarcest resource — find the bottleneck, not the most obvious factor |
| 81 | - "Simplicity changes behavior" — BJ Fogg |
| 82 | - Starter Steps: shrink the behavior to the tiniest version (2 minutes → 30 seconds → one field) |
| 83 | - Defaults are the most powerful ability tool — users rarely change them |
| 84 | |
| 85 | **Product applications:** |
| 86 | |
| 87 | | Context | Application | Example | |
| 88 | |---------|-------------|---------| |
| 89 | | **Signup** | Cut cost across all six factors | One-click SSO removes time, mental effort, non-routine | |
| 90 | | **Core action** | Fix the weakest link | Mental-effort bottleneck → smart defaults and templates | |
| 91 | | **Enterprise adoption** | Address social deviance | "Your team already uses this" reduces social risk | |
| 92 | |
| 93 | **Copy patterns:** |
| 94 | - "One click to get started" (time + physical effort) |
| 95 | - "No technical skills needed" (mental effort) |
| 96 | - "Works just like tools you already use" (non-routine) |
| 97 | |
| 98 | **Ethical boundary:** Reduce friction only on genuinely valuable behaviors — never make it too easy to overspend, over-share, or delete important data without confirmation. |
| 99 | |
| 100 | See: [references/ability-chain.md](references/ability-chain.md) for the six factors in detail, friction audit templates, and simplification strategies. |
| 101 | |
| 102 | ### 3. Prompt |
| 103 | |
| 104 | **Core concept:** The prompt says "do it now." Without one, behavior doesn't happen regardless of motivation and ability. Three types: Person Prompts (internal reminders), Context Prompts (environmental cues), Action Prompts (designed triggers from the product). |
| 105 | |
| 106 | **Why it works:** Teams assume motivation + ability is enough — it isn't, not without a well-timed prompt. But prompts only work above the Action Line: a push notification to someone lacking motivation or ability is spam. |
| 107 | |
| 108 | **Key insights:** |
| 109 | - A prompt at the wrong moment is noise; at the right moment, magic |
| 110 | - Anchor moments tie new behaviors to existing routines ("After I open Slack, I will...") |
| 111 | - Prompt fatigue is real — every unnecessary prompt degrades the value of future ones |
| 112 | |
| 113 | **Product applications:** |
| 114 | |
| 115 | | Context | Application | Example | |
| 116 | |---------|-------------|---------| |
| 117 | | **Notifications** | Prompt only above the Action Line | Send digest when there's content to review, not on a schedule | |
| 118 | | **Re-engagement** | Tie prompts to real events | "Your report is ready" (event-based, not time-based) | |
| 119 | | **Feature discovery** | Prompt when motivation and ability align | Feature tour appears when user hits the problem it solves | |
| 120 | |
| 121 | **Copy patterns:** |
| 122 | - "Your weekly report is ready" (context prompt — real event) |
| 123 | - "One thing left to complete your setup" (action prompt with progress) |
| 124 | - Never: "We miss you!" (product need, not user need) |
| 125 | |
| 126 | **Ethical boundary:** Every prompt must pass the test "Would I appreciate receiving this right now?" — if it serves a product metric (DAU, re-engagement) but not the user's current goal, cut it. |
| 127 | |
| 128 | See: [references/prompt-design.md](references/prompt-design.md) for prompt types, timing strategies, notification design, and anchor moments. |
| 129 | |
| 130 | ## Tiny Habits Method |
| 131 | |
| 132 | The practical application of B=MAP: make behaviors so small they need almost no motivation, anchor them to existing routines, and celebrate immediately. |
| 133 | |
| 134 | ### The Recipe |
| 135 | |
| 136 | ``` |
| 137 | After I [ANCHOR MOMENT], I will [TINY BEHAVIOR], then I [CELEBRATION]. |
| 138 | ``` |
| 139 | |
| 140 | - **Anchor Moment:** an existing routine that reliably happens (opening an app, finishing a meeting, morning coffee). |
| 141 | - **Tiny Behavior:** the smallest version of the target behavior — not "write a report" but "open the report template." |
| 142 | - **Celebration:** an immediate positive emotion that wires the habit. Repetition alone isn't enough — you need the feeling of success. |
| 143 | |
| 144 | ### Starter Steps |
| 145 | |
| 146 | Every target behavior has a Starter Step — the tiniest meaningful version: |
| 147 | |
| 148 | | Target Behavior | Starter Step | Why It Works | |
| 149 | |----------------|--------------|--------------| |
| 150 | | Complete onboarding | Fill in one field | Momentum from completion | |
| 151 | | Use analytics daily | Open the dashboard | Seeing data creates curiosity | |
| 152 | | Collaborate with team | Send one comment | Social reciprocity kicks in | |
| 153 | |
| 154 | ### Scaling Behaviors |
| 155 | |
| 156 | Once wired, tiny behaviors grow naturally: open dashboard → check a few metrics → customize → automatic morning habit. Never force scaling — let motivation and momentum drive expansion. The tiny version is the foundation, not a failure. |
| 157 | |
| 158 | See: [references/tiny-habits.md](references/tiny-habits.md) for the full Tiny Habits recipe, celebration techniques, and scaling patterns. |
| 159 | |
| 160 | ## Behavior Design Process |
| 161 | |
| 162 | Fogg's systematic process for lasting behavior change: |
| 163 | |
| 164 | ### Step 1: Clarify the Aspiration |
| 165 | What outcome does the user want — their aspiration, not the product's goal ("stay on top of my team's progress", not "increase DAU"). |
| 166 | |
| 167 | ### Step 2: Explore Behavior Options |
| 168 | List all possible behaviors that could achieve the aspiration. Be exhaustive — don't commit yet. |
| 169 | |
| 170 | ### Step 3: Match Behaviors |
| 171 | Assess each for motivation and ease; plot on a 2×2 of impact vs. feasibility (Focus Mapping). |
| 172 | |
| 173 | ### Step 4: Start Tiny |
| 174 | Shrink the best-matched behavior to its Starter Step; design the prompt; add celebration. |
| 175 | |
| 176 | ### Step 5: Optimize |
| 177 | Expand once wired. Fix bottlenecks with the Ability Chain; refine prompt timing from data. |
| 178 | |
| 179 | See: [references/product-applications.md](references/product-applications.md) when applying this process to a specific category — B=MAP mapped to SaaS onboarding, mobile, e-commerce, health, and education with per-category motivation timelines and bottlenecks. |
| 180 | |
| 181 | ## The Action Line |
| 182 | |
| 183 | ### Moving Behaviors Above the Action Line |
| 184 | |
| 185 | - **Increase Ability (move right)** — remove steps, pre-fill, defaults, templates, wizards. The most reliable approach. |
| 186 | - **Find better Prompts** — anchor to existing routines; event-based beats time-based; trigger when motivation is naturally higher. |
| 187 | - **Increasing Motivation (move up) is unreliable** — if you need motivation tactics, the behavior is probably too hard. |
| 188 | |
| 189 | ### Retention Diagnostics with B=MAP |
| 190 | |
| 191 | Map B=MAP to product metrics: |
| 192 | |
| 193 | | Metric | B=MAP Diagnosis | Action | |
| 194 | |--------|----------------|--------| |
| 195 | | **Low activation** | First action below the Action Line | Shrink onboarding to Starter Step; fix weakest Ability Chain link | |
| 196 | | **Day-1 drop-off** | Prompt failed or mistimed | Redesign first-day prompts; anchor to an existing routine | |
| 197 | | **Day-7 drop-off** | Motivation wave receded, behavior too hard | Reduce core action difficulty | |
| 198 | | **Day-30 drop-off** | Habit didn't form, no internal prompt | Create tiny habit recipe; add celebration loops | |
| 199 | | **Low feature adoption** | Feature below the Action Line for most users | Friction-audit it; prompt only when motivation is present | |
| 200 | | **Notification fatigue** | Prompts sent below the Action Line | Cut volume; send only with motivation + ability | |
| 201 | |
| 202 | See: [references/case-studies.md](references/case-studies.md) for a worked diagnosis of Instagram, Duolingo, Slack, Calm, and Peloton — read it to see how M, A, and P are scored independently on a real product before diagnosing your own. |
| 203 | |
| 204 | ## Common Mistakes |
| 205 | |
| 206 | | Mistake | Why It Fails | Fix | |
| 207 | |---------|-------------|------| |
| 208 | | **Relying on motivation for retention** | Motivation always recedes; products needing it fail at the trough | Make behaviors tiny enough to survive motivation dips | |
| 209 | | **Ignoring the Ability Chain bottleneck** | You optimized time but the barrier is mental effort or social deviance | Audit all six factors; fix the scarcest resource | |
| 210 | | **Prompting below the Action Line** | Notifications to unmotivated/unable users = spam | Event-based triggers only when motivation + ability suffice | |
| 211 | | **Skipping celebration in onboarding** | Without positive emotion, repetition doesn't wire habits | Add success states and micro-celebrations after key actions | |
| 212 | | **First action too ambitious** | "Complete your profile" is a project, not a behavior | Shrink to Starter Step: one field, one action | |
| 213 | | **Copying products without diagnosing B=MAP** | A high-motivation audience's design fails yours | Diagnose your users' motivation, ability, and prompt context first | |
| 214 | |
| 215 | ## Quick Diagnostic |
| 216 | |
| 217 | | Question | If No | Action | |
| 218 | |----------|-------|--------| |
| 219 | | Can a new user do the core action in under 60 seconds? | Ability too low | Friction audit; shrink to Starter Step | |
| 220 | | Does the product work when motivation is low? | Design depends on spikes | Redesign core behaviors for minimal motivation | |
| 221 | | Are prompts tied to real events or anchors? | Prompts feel like spam | Switch to event-based or anchor-based prompts | |
| 222 | | Is there immediate feedback after key actions? | No celebration = no habit wiring | Add success states, progress, social feedback | |
| 223 | | Have you found the weakest Ability Chain link? | Optimizing the wrong thing | Rate each of the six factors 1-5 for the core behavior | |
| 224 | | Do users scale naturally from tiny behaviors? | Forcing complexity too early | Starter Steps; let behaviors grow organically | |
| 225 | |
| 226 | ## Further Reading |
| 227 | |
| 228 | Based on BJ Fogg's behavior design research: |
| 229 | |
| 230 | - [*"Tiny Habits: The Small Changes That Change Everything"*](https://www.amazon.com/Tiny-Habits-Small-Changes-Everything/dp/0358003326?tag=wondelai00-20) by BJ Fogg |
| 231 | - [*"Designing for Behavior Change: Applying Psychology and Behavioral Economics"*](https://www.amazon.com/Designing-Behavior-Change-Psychology-Behavioral/dp/1492056030?tag=wondelai00-20) by Stephen Wendel (companion: applying behavior science to product design) |
| 232 | |
| 233 | ## About the Author |
| 234 | |
| 235 | **BJ Fogg, PhD** founded the Behavior Design Lab at Stanford University, where he has researched behavior change since 1998. He created the Fogg Behavior Model (B=MAP), coined the term "behavior design", and trained thousands of innovators — including Instagram co-founder Mike Krieger. *Tiny Habits* distills two decades of that research: lasting change comes from behaviors that are tiny, anchored, and celebrated. |
| 236 |
Reviews
Installed this one?Write the first review and take the Trailblazer badge.
Alternatives
Structure Your Invention For A Patent FilingDescribe your invention in plain words and get back a formal write-up that lays out the problem it solves, how it works, and which parts are worth protecting.●····●37/40Claims Drafting: The Core Patent SkillDescribe your invention in plain words and get back a numbered set of formal patent claims — the legal wording that defines exactly what you own.●····●36/40Patent Novelty and Non-Obviousness CheckDescribe your invention in everyday words and get back a clear read on whether it's new and original enough to patent, plus where it might hit trouble.●····●35/40Patent Pipeline: From Invention to FilingDescribe your invention in plain words and get back a complete first-draft patent application — claims, full description, and abstract — ready to hand to a patent attorney.●····●35/40