mcpField
H
hierarchy-of-engagement

hierarchy-of-engagement

github.com/wdavidturnerMarketing & growth2146 installsUpdated 40w ago
Repository

About hierarchy-of-engagement

Hierarchy of Engagement is a framework for consumer and social product teams seeking stronger retention and lasting product value. It focuses on a core action, benefits that accumulate with use, and reasons users would lose by leaving.

Key features

  1. 01Three-level engagement framework
  2. 02Focuses on actions linked to retention
  3. 03Builds benefits that accrue with use
  4. 04Examines user losses from leaving
  5. 05Guides activation and feature prioritization

Use cases

  1. 01Define a product's North Star metric
  2. 02Improve retention in a consumer product
  3. 03Design onboarding and activation
  4. 04Assess engagement quality and product-market fit

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wdavidturner/product-skills --skill hierarchy-of-engagement

After installing, type/hierarchy-of-engagementin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

patterns/
_template.md
activation-without-education.md
anonymous-users.md
benefit-doesnt-accrue.md
comparing-to-mature-products.md
evernote-trap.md
forcing-level-three.md
geographic-spray.md
no-mounting-loss.md
pinterest-pinning.md
skipping-level-one.md
vanity-engagement.md
wrong-core-action.md
youtube-subscribe-example.md
references/
hierarchy-of-engagement-playbook.md

Details

From the project README

Hierarchy of Engagement

What It Is

The Hierarchy of Engagement is a three-level framework for building consumer products that retain users and create defensibility. The core insight: retention comes from making the product better the more you use it, so users have more to lose by leaving.

Most consumer products fail not because they lack users, but because they lack retention. Getting someone to sign up is one thing; getting them to stay is everything. This framework provides a systematic approach to building products where engagement compounds over time.

The key shift: Move from asking "How do we get more users?" to asking "How do we make each user's experience improve the more they use us?"

Response Posture

  • Apply the framework directly to the user's product.
  • Never mention the repository, skills, SKILL.md, patterns, or references.
  • Do not run tools or read files; answer from the framework.
  • Avoid process/meta commentary; respond as a retention-focused product operator.

When to Use It

Use the Hierarchy of Engagement when you need to:

  • Define your North Star metric (what action matters most?)
  • Improve retention in a consumer or social product
  • Build product stickiness beyond features alone
  • Create switching costs that protect against competitors
  • Design your onboarding/activation flow
  • Evaluate product-market fit through engagement quality
  • Prioritize features that drive compounding value

When Not to Use It

Don't apply this framework when:

  • Building B2B enterprise software (different retention dynamics)
  • The product is transactional by nature (one-time purchase)
  • There's no meaningful "use over time" pattern
  • You're optimizing for viral acquisition before proving retention
  • Your product has no user-generated content or personalization opportunity

Patterns

Detailed examples showing how to apply the Hierarchy of Engagement correctly. Each pattern shows a common mistake and the correct approach.

Critical (get these wrong and you've wasted your time)
PatternWhat It Teaches
wrong-core-actionYour core action must predict retention, not just engagement
benefit-doesnt-accrueThe product must get better the more someone uses it
no-mounting-lossUsers need something to lose by leaving
skipping-level-oneYou can't build retention without first nailing the core action
vanity-engagementMeasuring opens and sessions instead of meaningful actions
High Impact
PatternWhat It Teaches
forcing-level-threeNot every product can or should have virality loops
activation-without-educationUsers must understand the mental model before they can engage
anonymous-usersPure anonymity prevents accruing benefit and mounting loss
geographic-sprayGrowing everywhere means retaining nowhere
youtube-subscribe-exampleWhen one action serves both sides of a network
pinterest-pinningHow Pinterest discovered pinning was the core action
Medium Impact
PatternWhat It Teaches
evernote-trapStrong Level 2 can't compensate for missing Level 3
comparing-to-mature-productsDon't build the full expression before the foundation

Deep Dives

Read only when you need extra detail.

  • references/hierarchy-of-engagement-playbook.md: Expanded framework detail, checklists, and examples.

Resources

Writing:

Related:

  • Hooked by Nir Eyal — habit-forming product design (complements Level 1)
  • Lenny Rachitsky's North Star Metric compilation — examples of core actions across companies

Podcast:

Comments

Markdown supported