Agent skill

Hooked UX

by wondelai in wondelai/skills

Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment).

MITAuto-check passedMarketing & SEO

Install Hooked UX

skills CLI
$ npx skills add wondelai/skills --skill hooked-ux -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wondelai/skills hooked-ux --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wondelai/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/hooked-ux .claude/skills/hooked-ux && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hooked-ux
GitHub stars
2.4k
Token cost
~3.5k tokens
SKILL.md length
1,633 words
Files
8 (incl. references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment).

  • Works in 4 steps: Trigger → Action → Variable Reward → …
  • The user mentions users arent coming back
  • SKILL.md covers Core Principle, Scoring, The Four Phases and The Habit Zone, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hooked UX is an agent skill from wondelai/skills. Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment). Use when the user mentions "users arent coming back", "habit formation", "engagement loops", "habit zone", or "the manipulation matrix". Also trigger when designing notification or re-engagement 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…

Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/case-studies.md`, `references/ethical-boundaries.md` and `references/habit-testing.md`).

It sits in Marketing & SEO, covering Social media marketing. The repository describes itself as: Wondel.ai Agent Skills — Business, Marketing, UX & Coding Frameworks from Bestselling Books. 50 skills + 12 guided journeys for Claude Code, Codex, Cursor & other agentskills.io… The licence is MIT.

When your agent uses it

  • The user mentions users arent coming back
  • Habit formation
  • Engagement loops
  • The manipulation matrix

Example prompts

  • “users arent coming back”
  • “habit formation”
  • “engagement loops”
  • “/hooked-ux”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Trigger
  2. Action
  3. Variable Reward
  4. Investment

What it can do on your machine

Read from SKILL.md and the folder at commit c172996. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • amazon.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hooked UX loads about 3.5k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 136 tokens; SKILL.md has 1,633 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~136
When it runs · the whole SKILL.md, loaded when a task matches
~3.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~18k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wondelai/skills at commit c172996, republished under its MIT licence (© wondelai). 1,633 words, ~3,479 tokens.

Download SKILL.mdSave it as .claude/skills/hooked-ux/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
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", "habit formation", "engagement loops", "habit zone", or "the manipulation matrix". Also trigger when designing notification or re-engagement 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
metadata.version
1.5.1

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, score the loop by the four Quick Diagnostic rows (internal trigger, dead-simple action, variable reward, investment loads next trigger): each row earns 2 (fully satisfied), 1 (partial), or 0 (absent), then score = round(total / 8 × 10). Then apply the ethics gate: if the Manipulation Matrix places the product as Dealer (or it hits any "When NOT to Use" condition), cap the score at 3 regardless of mechanics. Bands: 9-10 = complete loop, internal trigger identified, ethics clear; 5-6 = loop runs but leans on external triggers or predictable rewards; <=3 = broken loop or extractive design. Always state the current score and the specific diagnostic rows blocking 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 because the emotion itself fires before any reminder can.

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: Don't build triggers that fire on vulnerable emotional states (depression, addiction, grief) — those users can't exercise the autonomy the loop assumes.

See references/triggers.md when mapping triggers — the emotion-to-product mapping exercise and the external-to-internal transition plan.

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: When you simplify an action, don't strip the cost or consequence with it — a one-tap purchase must still surface the price and the commitment.

See references/product-applications.md when adapting the loop to your context — action and investment patterns for B2B SaaS, e-commerce, health, and productivity tools.

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 when designing a reward — tribe/hunt/self patterns, the four reinforcement schedules, and reward timing. For the dopamine/anticipation mechanism behind variable rewards, see references/neuroscience-foundations.md.

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.

Show full SKILL.md (634 more words)Show less

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 when running the test — cohort analysis, finding the Habit Path, and confirming the 5% threshold. For worked teardowns of these loops in real products (Instagram, Slack, Duolingo, Pinterest, and failures), see references/case-studies.md.

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 when the Manipulation Matrix flags a concern — dark-pattern catalog and how to protect vulnerable users.

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

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.

© wondelai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in hooked-ux of wondelai/skills.

  • SKILL.md
  • references/case-studies.md
  • references/ethical-boundaries.md
  • references/habit-testing.md
  • references/neuroscience-foundations.md
  • references/product-applications.md
  • references/rewards.md
  • references/triggers.md

Open the folder on GitHubat commit c172996

Compare with similar skills

Hooked UX next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hooked UX compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hooked UX this skillwondelai/skills2.4k—~3.5kAutomated safety check: PassMIT
Instagram Marketingsergebulaev/instagram-skills347—~1.9kAutomated safety check: NotesMIT
Getxapi ConnectLeoYeAI/openclaw-marketing-skills1k1 repos~715Automated safety check: PassCustom licence
Competitor Social ResearchScrapeCreators/social-media-research-skills3.4k—~1.1kAutomated safety check: NotesMIT
Business Contact and Social Links Finderbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
LinkedIn Ads Managementivangfalco/ads-skills279—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Instagram Marketing

    sergebulaev/instagram-skills

    Plan, draft, audit, and publish content for Instagram. An agent skill from sergebulaev/instagram-skills.

    347 GitHub stars~1.9k tokensUpdated 3 days ago
    Marketing & SEOAuto-check: notes
  • Getxapi Connect

    LeoYeAI/openclaw-marketing-skills

    Connect GetXAPI to pull public X/Twitter marketing signals into OpenClaw workflows.

    1k GitHub starsUsed in 1 repo~715 tokens
    Marketing & SEOAuto-check passed
  • Competitor Social Research

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to research competitors' social media strategy, compare brands or creators, find what content is working in a niche, identify content gaps, or produce a…

    3.4k GitHub stars~1.1k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes
  • Finds a company's official website and social profiles from its name, or collects social links from a website URL, using BrowserAct templates run by a Python script.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Marketing & SEOAuto-check passed
  • LinkedIn Ads Management

    ivangfalco/ads-skills

    Routes LinkedIn Ads work for B2B SaaS to the right playbook: campaign planning, performance analysis, account audits, creative, scaling and account-based campaigns.

    279 GitHub stars~1.7k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Buying Signal Monitor

    unifapi-agent/agents

    When a seller or SDR wants to catch public buying intent on X/Twitter and LinkedIn — someone asking for a tool they sell, complaining about or switching off a competitor, or hiring for a role that…

    589 GitHub stars~2.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from wondelai/skills

All 62 skills in this repo
  • Crossing The Chasm

    wondelai/skills

    Navigate the technology adoption lifecycle from early adopters to mainstream market.

    2.4k GitHub stars~3.6k tokensUpdated 29 days ago
    Auto-check passed
  • Design Everyday Things

    wondelai/skills

    Apply foundational design principles: affordances, signifiers, constraints, feedback, and conceptual models.

    2.4k GitHub stars~4k tokensUpdated 29 days ago
    Auto-check passed
  • Design Sprint

    wondelai/skills

    Run a structured 5-day process to prototype, test, and validate product ideas with real users.

    2.4k GitHub stars~3.8k tokensUpdated 29 days ago
    Auto-check passed
  • Improve Retention

    wondelai/skills

    Diagnose and fix retention problems using behavior design (B=MAP).

    2.4k GitHub stars~3.8k tokensUpdated 29 days ago
    Auto-check passed
  • Monetizing Innovation

    wondelai/skills

    Design products and pricing around validated willingness to pay, from Ramanujam & Tacke's "Monetizing Innovation".

    2.4k GitHub stars~5.2k tokensUpdated 29 days ago
    Auto-check passed
  • Predictable Revenue

    wondelai/skills

    Build a scalable outbound B2B sales machine with specialized roles (SDR, AE, CSM).

    2.4k GitHub stars~3.1k tokensUpdated 29 days ago
    Auto-check passed

Categories

Questions about Hooked UX

What does Hooked UX do?

Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment). Hooked UX is an agent skill from wondelai/skills. Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment).

When should I use Hooked UX?

Hooked UX fits situations like: the user mentions users arent coming back; habit formation; engagement loops; the manipulation matrix.

How do I install Hooked UX in Claude Code?

Run `npx skills add wondelai/skills --skill hooked-ux -a claude-code`. Or copy the skill folder (hooked-ux in wondelai/skills) into .claude/skills/hooked-ux in your project. Claude Code loads it when a task matches its description.

How do I install Hooked UX in Codex?

Run `npx skills add wondelai/skills --skill hooked-ux -a codex`. Or copy the skill folder (hooked-ux in wondelai/skills) into .agents/skills/hooked-ux in your project. Codex loads it when a task matches its description.

Can I use Hooked UX in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wondelai/skills --skill hooked-ux -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hooked-ux, .gemini/skills/hooked-ux, .github/skills/hooked-ux and .opencode/skills/hooked-ux in your project.

What does Hooked UX need to run?

SKILL.md names no scripts, command-line tools or credentials: Hooked UX is instructions for the agent only.

Does Hooked UX access the network?

SKILL.md names 1 domain. As links in the text: amazon.com. This is read from the text; nothing was executed.

Is Hooked UX safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hooked UX use?

Hooked UX is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hooked UX use?

About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 15k tokens, read only when the agent opens those files.

What are the alternatives to Hooked UX?

Skills that share tags, products or a category with Hooked UX: Instagram Marketing (sergebulaev/instagram-skills, 347 stars), Getxapi Connect (LeoYeAI/openclaw-marketing-skills, 1k stars), Competitor Social Research (ScrapeCreators/social-media-research-skills, 3.4k stars) and Business Contact and Social Links Finder (browser-act/skills, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hooked UX?

wondelai (a GitHub organization) maintains it in wondelai/skills, which has 2,371 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on September 10, 2026.

Source: wondelai/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.