Prompt Design Framework
Prompt design

Prompts are the most overlooked element in behavior design.
# Prompt Design Prompts are the most overlooked element in behavior design. Without a prompt, behavior doesn't happen — no matter how motivated or able the user is. ## Three Prompt Types ### 1. Person Prompts (Internal) **What they are:** Thoughts or reminders that come from within the user. "I should check my metrics." "Time to update the project." **How they form:** Through repeated association between a context and a behavior. After enough repetitions, the user thinks of the behavior automatically in that context. **Product implications:** - You cannot directly create Person Prompts - You create them indirectly by pairing external prompts with consistent contexts - Person Prompts are the goal — they mean the habit is formed - When users act without any external prompt, Person Prompts are driving behavior
Overview
Prompts are the most overlooked element in behavior design. Without a prompt, behavior doesn't happen — no matter how motivated or able the user is.
Manual install (npx, ZIP)
npx skills add wondelai/skills --skill prompt-design -g -a claude-codeConnects with Agent Alley MCP · agentalley.io/mcp
Files included
prompt-design.md8.7 KB
Read prompt-design.md here
wondelai/
Show the full text202 lines
Prompt Design
Prompts are the most overlooked element in behavior design. Without a prompt, behavior doesn't happen — no matter how motivated or able the user is.
Three Prompt Types
1. Person Prompts (Internal)
What they are: Thoughts or reminders that come from within the user. "I should check my metrics." "Time to update the project."
How they form: Through repeated association between a context and a behavior. After enough repetitions, the user thinks of the behavior automatically in that context.
Product implications:
- You cannot directly create Person Prompts
- You create them indirectly by pairing external prompts with consistent contexts
- Person Prompts are the goal — they mean the habit is formed
- When users act without any external prompt, Person Prompts are driving behavior
Measurement: Track organic sessions (sessions without a preceding notification or email). Rising organic sessions = Person Prompts forming.
2. Context Prompts (Environmental)
What they are: Cues in the user's environment that trigger behavior. A badge on an app icon. A browser tab that's always open. A physical location associated with a task.
How they work: The environment reminds the user to act. The cue doesn't come from the product's notification system — it comes from the user's existing context.
Product implications:
- Design for environmental persistence (widgets, browser tabs, badges, status bar items)
- Integrate into existing workflows (Slack integrations, email digests, calendar events)
- Physical environment matters: desktop apps have different context cues than mobile
Design strategies:
- App badges and notification counts (persistent visual cue)
- Browser start page or new tab integration
- Widget on phone home screen
- Calendar integrations (event = context cue)
- Slack/Teams bot messages in existing channels
3. Action Prompts (Designed)
What they are: Prompts deliberately designed and sent by the product. Push notifications, emails, in-app tooltips, CTAs, banners, and modals.
How they work: The product actively tells the user to do something at a specific moment.
Product implications:
- You have full control over timing, content, and frequency
- But Action Prompts are expensive — each one uses up attention capital
- Prompt fatigue is real: too many Action Prompts degrades all future prompts
- Action Prompts should feel like helpful reminders, not interruptions
Prompt Timing
The most important principle: Prompts only work above the Action Line. Sending a prompt to someone who lacks motivation or ability is not engagement — it's spam.
When to Prompt
| Timing Strategy | How It Works | Example |
|---|---|---|
| Event-based | Prompt triggered by a real event | "Your report is ready" (report was generated) |
| Anchor-based | Prompt tied to user's existing routine | "After your morning standup, check your dashboard" |
| State-based | Prompt triggered by user's product state | "You have 3 unread comments" (content waiting) |
| Completion-based | Prompt after user finishes a related action | "You just finished a meeting — want to log action items?" |
| Threshold-based | Prompt when a metric crosses a threshold | "Your project hit 80% completion" |
When NOT to Prompt
| Anti-Pattern | Why It Fails | Better Approach |
|---|---|---|
| Time-based schedule | "Every Monday at 9am" regardless of context | Event-based: prompt when there's something to act on |
| Re-engagement spam | "We miss you!" every 3 days | Wait for a meaningful event, then send one message |
| Feature promotion | "Have you tried our new analytics?" | Prompt when user encounters the problem analytics solves |
| Vanity metrics | "You've been viewed 12 times this week!" | Only prompt for actionable information |
| Guilt-based | "Your team is waiting" when they're not | Only use social prompts when genuinely true |
Notification Design
The PASS Framework for Notifications
Every notification should pass four tests:
P — Personal: Is this relevant to this specific user?
- Bad: "Check out our new features"
- Good: "Your project 'Q2 Launch' has 3 new comments"
A — Actionable: Can the user act on this right now?
- Bad: "Your subscription renews in 30 days"
- Good: "Sarah shared a file with you — tap to view"
S — Specific: Does it tell the user exactly what happened?
- Bad: "You have new activity"
- Good: "2 tasks were completed in your Sprint 4 board"
S — Short: Can the user get the point in under 3 seconds?
- Bad: "We wanted to let you know that there have been some updates to the project that you've been following, and several team members have added their contributions"
- Good: "3 updates in Project Alpha"
Notification Frequency Guidelines
| User Segment | Frequency | Rationale |
|---|---|---|
| New users (Week 1) | 1-2 per day max | Build value without overwhelming |
| Active users | Based on events, not schedule | They're engaged; prompt around real activity |
| Fading users | 1-2 per week max | High value, low volume to re-engage |
| Churned users | 1 per month max | Only prompt for highly relevant events |
Notification Hierarchy
Not all prompts are equal. Design a hierarchy:
- Critical: Requires immediate action (security alerts, time-sensitive deadlines)
- Important: Meaningful event that benefits from quick response (teammate mention, task completion)
- Informational: Nice to know but not urgent (weekly digest, milestone reached)
- Ambient: Background awareness (badge count update, status change)
Match the notification channel to the hierarchy level:
| Level | Channel | Interruption Level |
|---|---|---|
| Critical | Push notification + banner | Full interruption |
| Important | Push notification | Standard interruption |
| Informational | In-app + email digest | Low interruption |
| Ambient | Badge count, in-app indicator | No interruption |
Anchor Moments
Anchor moments are the key to forming habits. They are existing routines that serve as reliable triggers for new behaviors.
What Makes a Good Anchor
A good anchor moment is:
- Reliable: It happens consistently (daily, weekly)
- Recognizable: The user clearly knows when it happens
- Relevant: It's contextually related to the new behavior
- Already habitual: It doesn't require motivation — it's automatic
Common Anchor Moments for Products
| Anchor Moment | New Behavior | Recipe |
|---|---|---|
| Opening laptop in the morning | Check dashboard | "After I open my laptop, I will glance at my dashboard" |
| Finishing a meeting | Log action items | "After I leave a meeting, I will add one task" |
| Morning coffee | Review daily plan | "After I pour my coffee, I will check my priorities" |
| End of workday | Update project status | "After I close my IDE, I will update one status" |
| Weekly team standup | Review team metrics | "After our standup, I will check the team scoreboard" |
Designing for Anchor Moments
- Identify the anchor through user research (what do users already do reliably?)
- Pair the new behavior with the anchor (proximity in time and context)
- Prompt at the anchor moment (notification, email, or in-app cue)
- Shrink the new behavior to its Starter Step
- Celebrate after completion (feedback, progress, positive emotion)
Prompt Design Patterns
Progressive Prompt Reduction
As habits form, reduce external prompts:
| Week | Prompt Strategy | Goal |
|---|---|---|
| 1-2 | Daily action prompts | Establish the behavior |
| 3-4 | Reduce to every other day | Test if habit is forming |
| 5-8 | Weekly summary only | Shift to context/person prompts |
| 9+ | No external prompts | Habit formed (monitor organic sessions) |
The Prompt-Value Ratio
Every prompt should deliver more value than it costs in attention:
Prompt Value = (Relevance × Urgency × Actionability) / Frequency
If frequency goes up, each prompt must be more relevant, more urgent, or more actionable to maintain the same value ratio.
Prompt A/B Testing
Test prompts on these dimensions:
| Dimension | A | B |
|---|---|---|
| Timing | Morning send | Anchor-moment send |
| Content | Generic ("Check your dashboard") | Specific ("2 tasks due today") |
| Channel | Push notification | In-app banner |
| Frequency | Daily | Event-based |
| Tone | Informational ("Your report is ready") | Social ("Sarah commented on your project") |
Measure: Open rate, action completion rate, and long-term retention (not just clicks).
| 1 | # Prompt Design |
| 2 | |
| 3 | Prompts are the most overlooked element in behavior design. Without a prompt, behavior doesn't happen — no matter how motivated or able the user is. |
| 4 | |
| 5 | ## Three Prompt Types |
| 6 | |
| 7 | ### 1. Person Prompts (Internal) |
| 8 | |
| 9 | **What they are:** Thoughts or reminders that come from within the user. "I should check my metrics." "Time to update the project." |
| 10 | |
| 11 | **How they form:** Through repeated association between a context and a behavior. After enough repetitions, the user thinks of the behavior automatically in that context. |
| 12 | |
| 13 | **Product implications:** |
| 14 | You cannot directly create Person Prompts |
| 15 | You create them indirectly by pairing external prompts with consistent contexts |
| 16 | Person Prompts are the goal — they mean the habit is formed |
| 17 | When users act without any external prompt, Person Prompts are driving behavior |
| 18 | |
| 19 | **Measurement:** Track organic sessions (sessions without a preceding notification or email). Rising organic sessions = Person Prompts forming. |
| 20 | |
| 21 | |
| 22 | |
| 23 | ### 2. Context Prompts (Environmental) |
| 24 | |
| 25 | **What they are:** Cues in the user's environment that trigger behavior. A badge on an app icon. A browser tab that's always open. A physical location associated with a task. |
| 26 | |
| 27 | **How they work:** The environment reminds the user to act. The cue doesn't come from the product's notification system — it comes from the user's existing context. |
| 28 | |
| 29 | **Product implications:** |
| 30 | Design for environmental persistence (widgets, browser tabs, badges, status bar items) |
| 31 | Integrate into existing workflows (Slack integrations, email digests, calendar events) |
| 32 | Physical environment matters: desktop apps have different context cues than mobile |
| 33 | |
| 34 | **Design strategies:** |
| 35 | App badges and notification counts (persistent visual cue) |
| 36 | Browser start page or new tab integration |
| 37 | Widget on phone home screen |
| 38 | Calendar integrations (event = context cue) |
| 39 | Slack/Teams bot messages in existing channels |
| 40 | |
| 41 | |
| 42 | |
| 43 | ### 3. Action Prompts (Designed) |
| 44 | |
| 45 | **What they are:** Prompts deliberately designed and sent by the product. Push notifications, emails, in-app tooltips, CTAs, banners, and modals. |
| 46 | |
| 47 | **How they work:** The product actively tells the user to do something at a specific moment. |
| 48 | |
| 49 | **Product implications:** |
| 50 | You have full control over timing, content, and frequency |
| 51 | But Action Prompts are expensive — each one uses up attention capital |
| 52 | Prompt fatigue is real: too many Action Prompts degrades all future prompts |
| 53 | Action Prompts should feel like helpful reminders, not interruptions |
| 54 | |
| 55 | |
| 56 | |
| 57 | ## Prompt Timing |
| 58 | |
| 59 | The most important principle: **Prompts only work above the Action Line.** Sending a prompt to someone who lacks motivation or ability is not engagement — it's spam. |
| 60 | |
| 61 | ### When to Prompt |
| 62 | |
| 63 | | Timing Strategy | How It Works | Example | |
| 64 | |----------------|-------------|---------| |
| 65 | | **Event-based** | Prompt triggered by a real event | "Your report is ready" (report was generated) | |
| 66 | | **Anchor-based** | Prompt tied to user's existing routine | "After your morning standup, check your dashboard" | |
| 67 | | **State-based** | Prompt triggered by user's product state | "You have 3 unread comments" (content waiting) | |
| 68 | | **Completion-based** | Prompt after user finishes a related action | "You just finished a meeting — want to log action items?" | |
| 69 | | **Threshold-based** | Prompt when a metric crosses a threshold | "Your project hit 80% completion" | |
| 70 | |
| 71 | ### When NOT to Prompt |
| 72 | |
| 73 | | Anti-Pattern | Why It Fails | Better Approach | |
| 74 | |-------------|-------------|-----------------| |
| 75 | | **Time-based schedule** | "Every Monday at 9am" regardless of context | Event-based: prompt when there's something to act on | |
| 76 | | **Re-engagement spam** | "We miss you!" every 3 days | Wait for a meaningful event, then send one message | |
| 77 | | **Feature promotion** | "Have you tried our new analytics?" | Prompt when user encounters the problem analytics solves | |
| 78 | | **Vanity metrics** | "You've been viewed 12 times this week!" | Only prompt for actionable information | |
| 79 | | **Guilt-based** | "Your team is waiting" when they're not | Only use social prompts when genuinely true | |
| 80 | |
| 81 | |
| 82 | |
| 83 | ## Notification Design |
| 84 | |
| 85 | ### The PASS Framework for Notifications |
| 86 | |
| 87 | Every notification should pass four tests: |
| 88 | |
| 89 | **P — Personal:** Is this relevant to this specific user? |
| 90 | Bad: "Check out our new features" |
| 91 | Good: "Your project 'Q2 Launch' has 3 new comments" |
| 92 | |
| 93 | **A — Actionable:** Can the user act on this right now? |
| 94 | Bad: "Your subscription renews in 30 days" |
| 95 | Good: "Sarah shared a file with you — tap to view" |
| 96 | |
| 97 | **S — Specific:** Does it tell the user exactly what happened? |
| 98 | Bad: "You have new activity" |
| 99 | Good: "2 tasks were completed in your Sprint 4 board" |
| 100 | |
| 101 | **S — Short:** Can the user get the point in under 3 seconds? |
| 102 | Bad: "We wanted to let you know that there have been some updates to the project that you've been following, and several team members have added their contributions" |
| 103 | Good: "3 updates in Project Alpha" |
| 104 | |
| 105 | ### Notification Frequency Guidelines |
| 106 | |
| 107 | | User Segment | Frequency | Rationale | |
| 108 | |-------------|-----------|-----------| |
| 109 | | New users (Week 1) | 1-2 per day max | Build value without overwhelming | |
| 110 | | Active users | Based on events, not schedule | They're engaged; prompt around real activity | |
| 111 | | Fading users | 1-2 per week max | High value, low volume to re-engage | |
| 112 | | Churned users | 1 per month max | Only prompt for highly relevant events | |
| 113 | |
| 114 | ### Notification Hierarchy |
| 115 | |
| 116 | Not all prompts are equal. Design a hierarchy: |
| 117 | |
| 118 | **Critical:** Requires immediate action (security alerts, time-sensitive deadlines) |
| 119 | **Important:** Meaningful event that benefits from quick response (teammate mention, task completion) |
| 120 | **Informational:** Nice to know but not urgent (weekly digest, milestone reached) |
| 121 | **Ambient:** Background awareness (badge count update, status change) |
| 122 | |
| 123 | Match the notification channel to the hierarchy level: |
| 124 | |
| 125 | | Level | Channel | Interruption Level | |
| 126 | |-------|---------|-------------------| |
| 127 | | Critical | Push notification + banner | Full interruption | |
| 128 | | Important | Push notification | Standard interruption | |
| 129 | | Informational | In-app + email digest | Low interruption | |
| 130 | | Ambient | Badge count, in-app indicator | No interruption | |
| 131 | |
| 132 | |
| 133 | |
| 134 | ## Anchor Moments |
| 135 | |
| 136 | Anchor moments are the key to forming habits. They are existing routines that serve as reliable triggers for new behaviors. |
| 137 | |
| 138 | ### What Makes a Good Anchor |
| 139 | |
| 140 | A good anchor moment is: |
| 141 | **Reliable:** It happens consistently (daily, weekly) |
| 142 | **Recognizable:** The user clearly knows when it happens |
| 143 | **Relevant:** It's contextually related to the new behavior |
| 144 | **Already habitual:** It doesn't require motivation — it's automatic |
| 145 | |
| 146 | ### Common Anchor Moments for Products |
| 147 | |
| 148 | | Anchor Moment | New Behavior | Recipe | |
| 149 | |---------------|-------------|--------| |
| 150 | | Opening laptop in the morning | Check dashboard | "After I open my laptop, I will glance at my dashboard" | |
| 151 | | Finishing a meeting | Log action items | "After I leave a meeting, I will add one task" | |
| 152 | | Morning coffee | Review daily plan | "After I pour my coffee, I will check my priorities" | |
| 153 | | End of workday | Update project status | "After I close my IDE, I will update one status" | |
| 154 | | Weekly team standup | Review team metrics | "After our standup, I will check the team scoreboard" | |
| 155 | |
| 156 | ### Designing for Anchor Moments |
| 157 | |
| 158 | **Identify** the anchor through user research (what do users already do reliably?) |
| 159 | **Pair** the new behavior with the anchor (proximity in time and context) |
| 160 | **Prompt** at the anchor moment (notification, email, or in-app cue) |
| 161 | **Shrink** the new behavior to its Starter Step |
| 162 | **Celebrate** after completion (feedback, progress, positive emotion) |
| 163 | |
| 164 | |
| 165 | |
| 166 | ## Prompt Design Patterns |
| 167 | |
| 168 | ### Progressive Prompt Reduction |
| 169 | |
| 170 | As habits form, reduce external prompts: |
| 171 | |
| 172 | | Week | Prompt Strategy | Goal | |
| 173 | |------|----------------|------| |
| 174 | | 1-2 | Daily action prompts | Establish the behavior | |
| 175 | | 3-4 | Reduce to every other day | Test if habit is forming | |
| 176 | | 5-8 | Weekly summary only | Shift to context/person prompts | |
| 177 | | 9+ | No external prompts | Habit formed (monitor organic sessions) | |
| 178 | |
| 179 | ### The Prompt-Value Ratio |
| 180 | |
| 181 | Every prompt should deliver more value than it costs in attention: |
| 182 | |
| 183 | |
| 184 | Prompt Value = (Relevance × Urgency × Actionability) / Frequency |
| 185 | |
| 186 | |
| 187 | If frequency goes up, each prompt must be more relevant, more urgent, or more actionable to maintain the same value ratio. |
| 188 | |
| 189 | ### Prompt A/B Testing |
| 190 | |
| 191 | Test prompts on these dimensions: |
| 192 | |
| 193 | | Dimension | A | B | |
| 194 | |-----------|---|---| |
| 195 | | **Timing** | Morning send | Anchor-moment send | |
| 196 | | **Content** | Generic ("Check your dashboard") | Specific ("2 tasks due today") | |
| 197 | | **Channel** | Push notification | In-app banner | |
| 198 | | **Frequency** | Daily | Event-based | |
| 199 | | **Tone** | Informational ("Your report is ready") | Social ("Sarah commented on your project") | |
| 200 | |
| 201 | Measure: Open rate, action completion rate, and long-term retention (not just clicks). |
| 202 |
Details
- Updated
- Sep 10, 2026
- License
- MIT
- Stars on the repo
- ★ 2,235
- Checked
- Source
- wondelai/skills ↗
- Creator
- wondelai · 319 listings
Similar skills
See all →
SkillSkill Builder from Sources
SkillAnthropic Skill Creator
SkillAdvanced Prompt Patterns
SkillMarketing Prompt Testing
SkillPrompt Engineering Expert
AgentProduction Prompt OptimizerMore from wondelai
SkillSoftware Design Philosophy
SkillActionable Metrics Guide
SkillAdvertising Media
SkillAffordance Design
SkillLean UX in Agile Teams
SkillAMP Framework Practitioner