retention-engagement — Claude Code skill: how to install and use
Helps identify user churn drivers, track cohort survival curves, and introduce habit mechanics like streaks. Useful when onboarding friction causes early drop-off.
npx skills add RefoundAI/lenny-skills --skill retention-engagement -a claude-codeWhat retention-engagement does
The skill draws on 50 insights from 11 guests on Lenny's Podcast and Newsletter. It guides you in identifying user activation milestones and tracking cohort retention curves over time. The agent audits onboarding flows to flag friction points, such as brittle CSV importers that drive users away early.
It focuses on psychological loops, including streaks, loss aversion, and compounding user value. The skill checks whether a tool provides utility to an individual user before a team joins. It also flags deceptive activity metrics like app opens that mask real retention issues.
Acquisition cannot fix high churn. When monthly customer cancellation exceeds the 3 percent threshold, adding new users only hits a mathematical ceiling. Full guest notes reside in references/guest-insights.md.
What it helps with
- calculate cohort survival curves and identify when retention flattens
- eliminate onboarding friction that triggers early user drop-off
- implement streak mechanics and loss aversion to drive daily returns
- separate involuntary billing failures from real product dissatisfaction
Example prompts for the agent
- Help me build a cohort retention curve and find where it flattens
- Audit our user onboarding flow to spot friction causing early drop-offs
- Suggest habit-building mechanics like streaks to increase switching costs
How to install retention-engagement
1Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill retention-engagement -a claude-code2Manually: put the files in place
~/.claude/skills/retention-engagement/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/retention-engagement/
1Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill retention-engagement -a codex2Manually: put the files in place
.agents/skills/retention-engagement/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill retention-engagement -a cursor2Manually: put the files in place
.cursor/skills/retention-engagement/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install RefoundAI/lenny-skills retention-engagement2Manually: put the files in place
.github/skills/retention-engagement/SKILL.md1Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill retention-engagement -a gemini-cli2Platform CLI
gemini skills install https://github.com/RefoundAI/lenny-skills --path skills/retention-engagementManually: put the files in place
.devin/skills/retention-engagement/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill retention-engagement -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about retention-engagement
How do I install retention-engagement in Claude Code?
Run npx skills add RefoundAI/lenny-skills --skill retention-engagement -a claude-code. The file is placed at ~/.claude/skills/retention-engagement/SKILL.md.
What does the retention-engagement skill do?
It guides product teams through activation tracking, onboarding audits, and habit loops to curb churn. The guidance is based on insights from 11 podcast and newsletter contributors.
What common metrics mistakes does this skill flag?
It warns against treating app opens as real engagement, blending free and paid retention cohorts, and ignoring involuntary churn from failed payments.
Source text
SKILL.md · MIT
--- name: retention-engagement description: Help users identify the drivers of long-term retention and implement behavioral mechanics that keep customers coming back. This guide focuses on measuring the survival curve of users and optimizing the product environment for high frequency usage. --- # Retention and Engagement Mastery Build sustainable growth by embedding products into workflows and creating compounding user value. Help the user with retention and engagement mastery using insights from 11 guests and posts across Lenny's Podcast and Newsletter. ## How to Help 1. **Define metrics** - Guide the user in identifying their specific activation milestones and setting up cohort-based retention tracking. 2. **Audit friction** - Analyze the onboarding process and core user flows to eliminate technical and mental hurdles that cause early drop-off. 3. **Design habits** - Suggest psychological mechanics like streaks, loss aversion, or mounting value to increase switching costs. 4. **Benchmark performance** - Compare current churn and retention rates against industry-specific 'Good' and 'Great' standards to prioritize interventions. ## Core Principles ### Retention before monetization Albert Cheng: "User retention is gold for consumer subscription companies. If you don't retain your users, then a lot of the onus is on getting them to pay on day one." Prioritize a foundation of high user retention over aggressive early monetization to ensure sustainable long term growth. ### Onboarding as a retention driver Crystal W: "Well, based on our data about a third of people will consider switching to another company after just one bad experience during onboarding. So if your CSV importer doesn't work right, which is super common, considering customer files are chalked full of unexpected data and formatting, they'll leave." Treat the first experience as the most critical point for retention because users are prone to abandon a product at the first sign of friction. ### Survival curve measurement Dan Hockenmaier: "Second would be retention. So at what rate are these customers activating? And then have some kind of basic monthly retention curve. So how long are they staying around? What's the survival rate in each of these? And those kind of stack over time." Effective retention management requires tracking the long term survival curve of user cohorts rather than just high level active user counts. ### Strategic loss aversion Jackson Shuttleworth: "Streaks is the most impactful feature. We have, right now, over 9 million users with a year plus streak. If you look at the numbers, I think it's been our biggest growth lever. What Duolingo really focuses on is, how do we help users build habits around language learning?" Use mechanics like streaks to create a sense of progress that users want to protect, providing a powerful motivation to return daily. ### The churn ceiling Jason Cohen: "There's a maximum ceiling of how big you could ever be thanks to cancellations. And when you know what that number is, it's much more real and visceral and scary." Acknowledge that high churn creates a mathematical limit on business size that no amount of acquisition can solve. ### Mounting loss Sarah Tavel: "The test for me, of whether you're building a product that has the ingredients to create a retentive product on a micro level, just at the user level, is that the product should get better the more you use it, and you'll have more to lose by leaving it." Ensure the product becomes more valuable with every use, making the cost of abandoning the platform higher over time. ## Questions to Help Users - "What is the single action a user must take to realize the core value of your product?" - "At what specific point in time does your cohort retention curve usually flatten out?" - "Does your product provide utility to a single player before a network or team is established?" - "What valuable data or progress would a user lose if they stopped using your product today?" - "Is your monthly logo churn rate currently above or below the critical 3 percent threshold?" - "Are your retention metrics currently masking the behavior of free users by blending them with paid customers?" ## Common Mistakes to Flag - **Relying on acquisition to fix churn** - Marketing cannot overcome the mathematical growth ceiling created by a high cancellation rate. - **Using noise events for activity** - Broad metrics like app opens or screen views inflate active user counts without reflecting genuine value delivery. - **Ignoring involuntary churn** - Failing to distinguish between payment failures and product dissatisfaction leads to ineffective recovery strategies. - **Delayed activation efforts** - Waiting too long to connect a user to value allows them to drop off before they experience the product's benefits. ## Deep Dive For all 50 sourced insights from 11 guests, see `references/guest-insights.md` ## Related Skills - Growth Model - Acquisition Channels - User Onboarding Activation - Referrals Word Of Mouth
© RefoundAI · MIT · RefoundAI/lenny-skills