referrals-word-of-mouth — Claude Code skill: referral programs
Turns accidental word-of-mouth into a structured referral program and viral product loops. Useful once growth already comes in on its own and you want more of it.
npx skills add RefoundAI/lenny-skills --skill referrals-word-of-mouth -a claude-codeWhat referrals-word-of-mouth does
The skill walks the agent through four steps: assess whether the product is ready, map its natural viral loops, design the incentive structure, then measure the referral funnel. It ships with templates — a readiness checklist, a three-phase build based on the Airbnb model, six strategies for raising sharing rate, the K-factor formula, a metrics dashboard, and a taxonomy of seven virality types. There is also a Purple Cow test for whether the product is worth a remark in the first place.
The material comes from episodes of Lenny's Podcast and the newsletter, with quotes and a list of common mistakes. The skill is blunt about one thing: a referral program only adds fuel to an existing fire, so build it after most signups already arrive organically. If the product is not meaningfully faster, cheaper or easier than the alternatives, synthetic loops will not fix that.
The most practical part is the questions it asks you first: what share of signups come from direct and organic channels, where is the moment a user would actually tell a friend about, is the product naturally multiplayer. Your answers decide whether to start now. The skill installs into Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.
What it helps with
- decide whether the product is ready for a referral program
- find the natural moments where users share the product
- set rewards that stay inside CAC limits
- move the referral program out of a buried settings menu
- measure K-factor and see how many new users one user brings
Example prompts for the agent
- run the readiness checklist and tell me if my product is ready for a referral program
- map the viral loops in my onboarding and suggest where to place the invite
- calculate the K-factor from this data and tell me what to fix first
How to install referrals-word-of-mouth
1Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill referrals-word-of-mouth -a claude-code2Manually: put the files in place
~/.claude/skills/referrals-word-of-mouth/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/referrals-word-of-mouth/
1Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill referrals-word-of-mouth -a codex2Manually: put the files in place
.agents/skills/referrals-word-of-mouth/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill referrals-word-of-mouth -a cursor2Manually: put the files in place
.cursor/skills/referrals-word-of-mouth/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install RefoundAI/lenny-skills referrals-word-of-mouth2Manually: put the files in place
.github/skills/referrals-word-of-mouth/SKILL.md1Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill referrals-word-of-mouth -a gemini-cli2Platform CLI
gemini skills install https://github.com/RefoundAI/lenny-skills --path skills/referrals-word-of-mouthManually: put the files in place
.devin/skills/referrals-word-of-mouth/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add RefoundAI/lenny-skills --skill referrals-word-of-mouth -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 referrals-word-of-mouth
How do I install referrals-word-of-mouth in Claude?
Run npx skills add RefoundAI/lenny-skills --skill referrals-word-of-mouth -a claude-code. The skill file then lands at ~/.claude/skills/referrals-word-of-mouth/SKILL.md.
What does referrals-word-of-mouth do?
It guides the agent from assessing product readiness to measuring the referral funnel. Templates cover incentive design, viral loop mapping and program metrics.
When should you not launch a referral program?
The skill says to confirm first that growth is mostly organic. A program amplifies existing word-of-mouth rather than creating it from nothing.
Source text
SKILL.md · MIT
--- name: referrals-word-of-mouth description: Help users build sustainable growth engines by transitioning from accidental word-of-mouth to structured referral programs and viral product loops. --- # Referrals and Word-of-Mouth Turn user satisfaction into a high-leverage growth engine through organic advocacy and structured referral loops. Help the user with referrals and word-of-mouth using insights from 13 guests and posts across Lenny's Podcast and Newsletter. ## How to Help 1. **Assess readiness** - Determine if the product has sufficient organic word-of-mouth and retention to support a formal referral program. 2. **Identify viral loops** - Map out the product natural social actions to choose the right type of virality such as word-of-mouth, invitation, or experiential. 3. **Design incentives** - Craft a reward structure that balances selfish, altruistic, and FOMO motivations within CAC limits. 4. **Optimize and scale** - Measure the referral funnel and place touchpoints throughout the user journey to maximize discoverability. ## Core Principles ### Remarkableness as a Core Value Rahul Vohra: "It is word of mouth. It is the virality you can't measure that isn't a mechanic that isn't in a feature. It is when one user spontaneously tells another user about your product." Sustainable growth is earned through extraordinary quality and delight that makes a product worthy of spontaneous attention rather than temporary gimmicks. ### The 10x Performance Threshold Nilan Peiris: "But to get to recommendation, you're going to blow your user socks off. You have to give them an experience they didn't know was previously possible. And when you are in that place of doing something that no one has ever done before, that's when you get it." To trigger true word-of-mouth, the product must be exponentially better than the status quo, typically by being significantly faster, cheaper, or easier to use. ### Accelerate Existing Organic Growth From "Building a referrals program": "The added incentive that a referral program offers simply adds fuel to an existing fire. I haven’t seen referrals work when there wasn’t strong existing WOM." A referral program acts as an accelerator for existing interest. It should only be built once you verify that a majority of growth is already organic. ### High-Value Milestone Incentives From "Kickstarting supply in a labor marketplace": "Later, we had a two-sided referral program where if supply referred new supply, we would pay them $50 for each activated pro (after completing their first gig). If they referred a restaurant we would give them something like $300." Structure referral payouts to occur only after the referred user reaches a clear activation milestone, such as completing their first transaction. ### Product-Led Virality Carilu Dietrich: "In order to get hypergrowth, you have to have organic, inbound, and viral word of mouth. You can't pay enough to grow at those rates and have a viable company." Hypergrowth is driven by an amazing product experience that people are naturally excited to share, rather than unsustainable paid acquisition spend. ### Community De-risking Camille Ricketts: "In terms of how I think about what it actually is, it's when your community helps you achieve such ubiquity and such name recognition that it actually allows you to start moving upmarket into the enterprise. And I know that might be very specific to enterprise oriented companies, but that's how we defined it at Notion was the fact that so many people were talking about this, sharing what they had built about it, honestly starting businesses of their own around it to formalize the relationship with teams that I think it de-risked Notion as a choice for a lot of companies" A passionate community creates brand ubiquity and user-generated social proof, which is critical for lowering perceived risk for new buyers. ## Templates & Frameworks - **Referral Program Readiness Checklist** (Building a referrals program) - Five qualifying criteria to evaluate before investing in building a referral program. Use this to decide go/no-go. - **Three-Phase Referral Program Build (Airbnb Model)** (Building a referrals program) - Phased approach to building and scaling a referral program, based on how Airbnb evolved its host referral program from nascent to top growth driver. - **Six Strategies to Increase Sharing Rate** (How to increase virality) - Six distinct strategies for getting users to share your product more often, each with examples and 'How Might You' brainstorming prompts - **K-Factor Virality Formula** (How to increase virality) - The standard formula for measuring viral growth, measuring the number of new users each existing user drives - **Referral Program Metrics Dashboard** (Building a referrals program) - The key output and input metrics to track for a referral program, based on Airbnb's host referral program. - **Seven Types of Virality Taxonomy** (How to increase virality) - A classification system of seven distinct types of virality organized into three categories, each with real product examples - **Purple Cow / Remarkability Test** (Seth Godin) - A framework for evaluating whether your product has built-in word-of-mouth potential by being worth making a remark about. - **Dropbox's Referral Program Growth** (Generating buzz) - Dropbox's referral program offering free storage to both referrer and referee, contributing to growth from 100k to 4M users in 15 months See `references/artifacts.md` for the full list with details. ## Questions to Help Users - "What percentage of your current signups are coming from direct or organic search channels?" - "What is the core remarkable moment in your product that users would actually tell a friend about?" - "Is your product naturally multiplayer or does it provide more value when more people use it?" - "Have you identified the incentive plateau where increasing a referral reward no longer improves conversion?" - "How are you currently tracking 'How did you hear about us?' data during your onboarding?" - "Are your referral incentives aligned with a high-value user milestone or just a simple signup?" ## Common Mistakes to Flag - **Manufacturing virality from a mediocre product** - If the core experience is not remarkable, synthetic loops and incentives will fail to create sustainable growth. - **Misaligning referral incentives** - Offering rewards that do not motivate users or that exceed the customer acquisition cost limits leads to inefficient spend. - **Ignoring the supply side** - Referral programs often provide more leverage on the supply side of a marketplace than the demand side, but are often overlooked. - **Poor program discoverability** - Burying the referral program in a settings menu instead of surfacing it at moments of high user satisfaction limits its volume. ## Deep Dive For all 36 sourced insights from 13 guests, see `references/guest-insights.md` ## Related Skills - Growth Model - Acquisition Channels - User Onboarding Activation - Retention Engagement
© RefoundAI · MIT · RefoundAI/lenny-skills