PluginBench
Skill
Review
Audit score 70

hooked-ux

wondelai/skills

How to install hooked-ux

npx skills add https://github.com/wondelai/skills --skill hooked-ux
Claude Code
Cursor
Windsurf
Cline
Full instructions (SKILL.md)

Source of truth, from wondelai/skills.


name: hooked-ux description: 'Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment). Use when the user mentions "users arent coming back", "engagement loops", "habit formation", "push notifications", "variable rewards", "daily active users", "habit zone", "user retention loops", "build a habit", "increase engagement", or "how do I get users to return". Also trigger when designing notification strategies, building streaks or progress systems, or analyzing why users stop after signup. Covers ethics evaluation and onboarding for habits. For friction reduction and B=MAP, see improve-retention. For viral sharing, see contagious.' license: MIT metadata: author: wondelai version: "1.4.0"

Hook Model Framework

Framework for building habit-forming products. Habits are not created — they are built through successive cycles through the Hook.

Core Principle

The Hook Model = a four-phase loop that connects the user's problem to your solution frequently enough to form a habit, moving usage from deliberate to automatic.

Trigger → Action → Variable Reward → Investment
    ↑                                      │
    └──────────────────────────────────────┘

Scoring

Goal: 10/10. When reviewing or creating product engagement mechanics, rate them 0-10 based on adherence to the principles below. A 10/10 means full alignment with all guidelines; lower scores indicate gaps to address. Always provide the current score and specific improvements needed to reach 10/10.

The Four Phases

1. Trigger

Core concept: The actuator of behavior. Triggers are external (environment-driven: notifications, emails, ads) or internal (emotion-driven) — and the goal is to migrate users from external to internal triggers.

Why it works: Every habit starts with a cue. External triggers get users started, but internal triggers — boredom, loneliness, uncertainty, FOMO — drive unprompted usage; when your product becomes the automatic response to an emotion, you have a habit.

Key insights:

  • Map your product to the specific negative emotion it resolves (boredom, loneliness, confusion, FOMO)
  • Effective external triggers are well-timed, actionable, and lead to the simplest possible next action
  • If users still need external prompts after ~30 days, no internal trigger has formed

Product applications:

ContextApplicationExample
OnboardingExternal triggers establish the first loopWelcome email with one clear action
RetentionMap product to internal emotional triggerInstagram resolves boredom; Google resolves confusion
Re-engagementExternal triggers bridge gaps until habit formsPush: "Your friend just posted a photo"

Copy patterns:

  • "Don't miss what happened while you were away" (FOMO trigger)
  • "Your friend just..." (social trigger bridging to internal)
  • "Pick up where you left off" (routine trigger)

Ethical boundary: Never exploit vulnerable emotional states (depression, addiction, grief) — triggers should connect users to genuine value, not manufacture anxiety to drive opens.

See: references/triggers.md for trigger design, emotion mapping, and external-to-internal transition strategies.

2. Action

Core concept: The simplest behavior done in anticipation of a reward, guided by the Fogg Behavior Model: Behavior = Motivation + Ability + Trigger, all converging at the same moment.

Why it works: Increasing motivation is hard and unreliable; reducing friction (increasing ability) is easier and more effective. Every extra step, field, or decision is a drop-off point.

Key insights:

  • Six elements of simplicity: time, money, physical effort, brain cycles, social deviance, non-routine
  • The action is the simplest behavior in anticipation of reward — not the full task
  • Hick's Law: more choices = slower decisions; reduce options to increase action rate

Product applications:

ContextApplicationExample
Signup flowMinimize fields and stepsOne-click Google/Apple sign-in
Core actionCompletable in secondsTwitter: type 280 characters and post
Progressive disclosureAsk for more only after initial rewardDuolingo: play first, create account later

Copy patterns:

  • "Just one tap to..." (emphasizes simplicity)
  • "No credit card required" (money/risk simplicity)
  • Buttons should be verbs: "Post", "Save", "Share" — not "Submit" or "Continue"

Ethical boundary: Reduce friction on genuinely valuable actions only — dark patterns that hide costs or consequences behind simple actions are unethical.

See: references/product-applications.md for action and investment design across product types.

3. Variable Reward

Core concept: The phase that keeps users coming back. Anticipation of reward — not the reward itself — creates dopamine, and rewards must be variable (unpredictable) to sustain engagement.

Why it works: The brain's dopamine system responds most strongly to anticipation of uncertain rewards — the slot machine effect. Three reward types — tribe (social), hunt (resources), self (mastery) — tap fundamental human drives.

Key insights:

  • Tribe = social validation; Hunt = search for resources/information; Self = personal mastery
  • Predictable rewards lose power; finite variability eventually becomes predictable — aim for infinite variability
  • Autonomy is critical: users must feel in control; forced engagement backfires

Product applications:

ContextApplicationExample
Social features (Tribe)Variable social validationInstagram likes — you never know how many
Content feeds (Hunt)Unpredictable resource streamInfinite scroll with algorithmically varied content
Gamification (Self)Accomplishment with variable difficultyDuolingo streaks + surprise bonus challenges

Copy patterns:

  • "See what's new" (implies variability)
  • "3 people responded to your post" (tribe reward, variable quantity)
  • "You've unlocked a new achievement!" (self reward, unexpected)

Ethical boundary: If users consistently feel worse after engaging (regret, time loss, anxiety), the reward system is extractive — avoid infinite scroll without natural stopping points.

See: references/rewards.md for reward design patterns, reinforcement schedules, and reward timing.

4. Investment

Core concept: Users invest something — time, data, effort, social capital, money — that improves the product for next use, raises switching costs, and loads the next trigger.

Why it works: People value what they put effort into (the IKEA effect). Investment is not about immediate reward — it improves the next cycle, creating a self-reinforcing loop.

Key insights:

  • Investment should come after reward, not before — users invest when they feel good
  • Each investment should load the next trigger (posting content triggers reply notifications)
  • Small investments compound: preferences → better recommendations → more usage; stored value grows over time

Product applications:

ContextApplicationExample
Data investmentHistory improves personalizationSpotify: more listening = better recommendations
Content investmentUser-created content they won't abandonInstagram posts, Notion documents
Reputation/social investmentSocial capital that exists only on-platformAirbnb host ratings, LinkedIn network

Copy patterns:

  • "Complete your profile to get better matches" (investment → future value)
  • "The more you use it, the smarter it gets" (compound investment)
  • "Invite your team to collaborate" (social investment)

Ethical boundary: Investment should genuinely improve the experience — never trap users with artificial switching costs or impossible data export; make staying the better choice through real value.

The Habit Zone

Two axes determine if a product can become a habit:

Low FrequencyHigh Frequency
High Perceived ValueViable product (needs ads/marketing)HABIT ZONE
Low Perceived ValueFailureFailure

Ask: how often do users need to engage, what's the perceived value of each engagement, and is frequency high enough to form automatic behavior?

Habit Testing

The 5% rule: a habit has formed when at least 5% of users show unprompted, habitual usage.

Three questions:

  1. Who are the habitual users? Which users engage most frequently, and what do they share?
  2. What are they doing? Identify the "Habit Path" — the action sequence that separates power users from casual users.
  3. Why are they doing it? What internal trigger and emotion precede usage?

See: references/habit-testing.md for testing methodology.

The Manipulation Matrix

Framework for evaluating the ethics of habit-forming products:

Maker Uses ProductMaker Doesn't Use
Materially Improves User's LifeFacilitatorPeddler
Doesn't Improve LifeEntertainerDealer

Ask: would I use this myself? Does it genuinely help users achieve their goals? Am I exploiting vulnerabilities or serving needs?

When NOT to Use the Hook Model

  • Your product doesn't genuinely improve lives
  • You're targeting vulnerable populations (children, addiction-prone users)
  • The business model depends on user regret
  • Engagement conflicts with user wellbeing

See: references/ethical-boundaries.md for comprehensive ethics guidance.

Regulatory Context

Watch emerging regulation: children's apps (COPPA, GDPR-K), dark patterns (rising FTC enforcement), "addictive" notification practices, and loot boxes (expanding gaming rules).

Onboarding Audit Checklist

Optimizing onboarding for habit formation:

First Trigger

  • First action obvious and easy; right external trigger for this user
  • Value proposition clear before asking for investment

First Action

  • Core action completable in under 60 seconds, friction removed
  • UI familiar (no new learning required)

First Reward

  • Immediate feedback with a variable element (surprise, delight)
  • Reward connects to an internal trigger

First Investment

  • Investment asked after reward (not before), small but meaningful
  • Investment loads the next trigger

Loop Completion

  • Clear path back to the trigger; external triggers sent at appropriate times
  • Progression through the Hook is measured

Common Mistakes

MistakeWhy It FailsFix
Relying on external triggers indefinitelyYou're renting attention, not building habitsMap product to an emotion; transition to internal triggers within 30 days
Making the core action too complexUsers drop off before the rewardSimplify to minimum viable action; apply the six ability factors
Using predictable rewardsDopamine response fades with noveltyAdd variability across tribe, hunt, and self rewards
Asking for investment before rewardUsers haven't received value yetSequence: trigger, action, reward, THEN investment
Ignoring the ethics of your hookUser regret, backlash, regulatory riskUse the Manipulation Matrix; be a Facilitator, not a Dealer

Quick Diagnostic

Audit any product feature:

QuestionIf NoAction
What's the internal trigger?Users need reminders to use itResearch user emotions
Is the action dead simple?Users start but don't completeRemove friction
Is the reward variable?Users get boredAdd unpredictability
Does investment load next trigger?Users don't returnConnect investment to triggers

Reference Files

Further Reading

Based on the Hook Model developed by Nir Eyal:

About the Author

Nir Eyal taught at Stanford Graduate School of Business and the Hasso Plattner Institute of Design, after working in the gaming and advertising industries where he saw habit psychology firsthand. Hooked distills that research into a framework used by product teams from startups to Fortune 500s; his follow-up Indistractable addresses resisting the same triggers.

Related skills

More from wondelai/skills and the wider catalog.

WE

web-typography

wondelai/skills

Select, pair, and implement typefaces for web projects. Use when the user mentions "font pairing", "which typeface", "line height", "responsive typography", "web font loading", "type hierarchy", "variable fonts", "FOUT/FOIT", "typographic scale", "choose a font", "improve readability", or "the text is hard to read". Also trigger when choosing between system fonts and web fonts, optimizing font-loading performance, or designing readable long-form content. Covers readability evaluation, CSS implementation, and performance optimization. For overall UI design systems, see refactoring-ui. For dramatic typographic experiences, see top-design.

4.4k installs
RE

refactoring-ui

wondelai/skills

Audit and fix visual hierarchy, spacing, color, and depth in web UIs. Use when the user mentions "my UI looks off", "make it look better", "this looks amateur", "looks unprofessional", "fix the design", "Tailwind styling", "color palette", "visual hierarchy", "design system", "spacing scale", or "component styling". Also trigger when building consistent design tokens, creating dark mode themes, improving data-visualization clarity, or polishing UI details before launch. Covers grayscale-first workflow, constrained design scales, shadows, and component styling. For typeface selection, see web-typography. For usability audits, see ux-heuristics.

4.4k installs
UX

ux-heuristics

wondelai/skills

Evaluate and improve interface usability using heuristic analysis. Use when the user mentions "usability audit", "UX review", "users are confused", "heuristic evaluation", "form usability", "navigation problems", "Nielsen heuristics", "cognitive walkthrough", "usability testing", "is this easy to use", "find usability problems", or "people get lost in our app". Also trigger when reviewing a design for usability issues, improving form-completion rates, or evaluating information architecture and navigation. Covers Nielsen''s 10 heuristics, severity ratings, and information architecture. For visual design fixes, see refactoring-ui. For conversion-focused audits, see cro-methodology.

4.1k installs
TO

top-design

wondelai/skills

Create award-winning, immersive web experiences at the level of Awwwards-featured agencies. Use when the user mentions "premium website", "portfolio site", "scroll animations", "Awwwards quality", "brand experience", "cinematic web design", "parallax storytelling", "agency-quality site", "make my site stunning", "give it a wow factor", or "an impressive website". Also trigger when building a landing page that needs to impress, designing a creative portfolio, or elevating a standard website into a memorable digital experience. Covers dramatic typography, purposeful motion, scroll-based composition, and performance-optimized animation. For foundational UI, see refactoring-ui. For type selection, see web-typography.

3.5k installs
IO

ios-hig-design

wondelai/skills

Design native iOS interfaces following Apple Human Interface Guidelines. Use when the user mentions "iPhone app", "iPad layout", "SwiftUI", "UIKit", "Dynamic Island", "safe areas", "HIG compliance", "SF Symbols", "haptic feedback", "iOS accessibility", "make my app feel native", or "follow Apple design guidelines". Also trigger when building tab bars, navigation stacks, sheets, or modals for iOS, implementing dark mode, or adapting layouts across screen sizes. Covers navigation patterns, accessibility, SF Symbols, and platform conventions. For general UI polish, see refactoring-ui. For affordance design, see design-everyday-things.

3.5k installs
JO

jobs-to-be-done

wondelai/skills

Discover what customers truly need by analyzing the "job" they hire your product to do. Use when the user mentions "customer discovery", "why customers churn", "what job does this solve", "competing against luck", "product-market fit", "switching behavior", "milkshake moment", "functional vs emotional jobs", "why do customers actually buy", or "understand what customers really need". Also trigger when investigating why users choose competitors, designing features around real customer needs, or reframing a value proposition. Covers JTBD interviews, competition analysis, and jobs-oriented roadmaps. For product positioning, see obviously-awesome. For rapid validation, see design-sprint.

3.5k installs