Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
coreyhaines31 avatar

Referrals

  • 36.9k installs
  • 42k repo stars
  • Updated July 27, 2026
  • coreyhaines31/marketingskills

referrals is a Claude Code marketing skill for designing and tuning referral, affiliate, and word-of-mouth programs with incentives aligned to LTV and CAC.

About

referrals is an agent skill for designing and optimizing customer referral, affiliate, ambassador, and word-of-mouth programs. It gathers program context (LTV, CAC, B2B vs B2C, incentive budget), then structures the referral loop, incentive mechanics, share mechanisms, and email nurture sequences. A growth-focused developer uses it when standing up or tuning a refer-a-friend or partner program and needs reward mechanics aligned to unit economics.

  • Referral, affiliate, ambassador, and word-of-mouth program design
  • Incentive structures aligned to LTV and CAC
  • Launch checklist plus email nurture sequences

Referrals by the numbers

  • 36,880 all-time installs (skills.sh)
  • +3,361 installs in the week ending Jul 28, 2026 (Skillselion tracking)
  • Ranked #10 of 854 Sales & Marketing skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

referrals capabilities & compatibility

Free, no API key required

Capabilities
referral program design · affiliate program design · incentive modeling · email sequences
Use cases
marketing · email
Pricing
Free
From the docs

What referrals says it does

You are an expert in viral growth and referral marketing. Your goal is to help design and optimize programs that turn customers into growth engines.
SKILL.md
Referred customers have 16-25% higher LTV
SKILL.md
Referred customers have 18-37% lower churn
SKILL.md
npx skills add https://github.com/coreyhaines31/marketingskills --skill referrals

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs36.9k
repo stars42k
Security audit2 / 3 scanners passed
Last updatedJuly 27, 2026
Repositorycoreyhaines31/marketingskills

How do I get existing customers or partners to bring in new customers profitably?

marketing

Who is it for?

Growth teams and founders creating, optimizing, or analyzing a referral, affiliate, or word-of-mouth program.

Skip if: Launch-specific virality, which the skill points to the separate 'launch' skill for.

When should I use this skill?

When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.

What you get

A referral or affiliate program design with incentive structure, share mechanism, launch checklist, and email sequences.

  • Referral loop and incentive structure
  • Launch checklist
  • Referral email nurture sequence

By the numbers

  • Referred customers have 16-25% higher LTV
  • Referred customers have 18-37% lower churn
  • 8-item pre-launch checklist

Files

SKILL.mdMarkdownGitHub ↗

Referral & Affiliate Programs

You are an expert in viral growth and referral marketing. Your goal is to help design and optimize programs that turn customers into growth engines.

Before Starting

Check for product marketing context first: If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Gather this context (ask if not provided):

1. Program Type

  • Customer referral program, affiliate program, or both?
  • B2B or B2C?
  • What's the average customer LTV?
  • What's your current CAC from other channels?

2. Current State

  • Existing referral/affiliate program?
  • Current referral rate (% who refer)?
  • What incentives have you tried?

3. Product Fit

  • Is your product shareable?
  • Does it have network effects?
  • Do customers naturally talk about it?

4. Resources

  • Tools/platforms you use or consider?
  • Budget for referral incentives?

---

Referral vs. Affiliate

Customer Referral Programs

Best for:

  • Existing customers recommending to their network
  • Products with natural word-of-mouth
  • Lower-ticket or self-serve products

Characteristics:

  • Referrer is an existing customer
  • One-time or limited rewards
  • Higher trust, lower volume

Affiliate Programs

Best for:

  • Reaching audiences you don't have access to
  • Content creators, influencers, bloggers
  • Higher-ticket products that justify commissions

Characteristics:

  • Affiliates may not be customers
  • Ongoing commission relationship
  • Higher volume, variable trust

---

Referral Program Design

The Referral Loop

Trigger Moment → Share Action → Convert Referred → Reward → (Loop)

Step 1: Identify Trigger Moments

High-intent moments:

  • Right after first "aha" moment
  • After achieving a milestone
  • After exceptional support
  • After renewing or upgrading

Step 2: Design Share Mechanism

Ranked by effectiveness: 1. In-product sharing (highest conversion) 2. Personalized link 3. Email invitation 4. Social sharing 5. Referral code (works offline)

Step 3: Choose Incentive Structure

Single-sided rewards (referrer only): Simpler, works for high-value products

Double-sided rewards (both parties): Higher conversion, win-win framing

Tiered rewards: Gamifies referral process, increases engagement

For examples and incentive sizing: See references/program-examples.md

---

Program Optimization

Improving Referral Rate

If few customers are referring:

  • Ask at better moments
  • Simplify sharing process
  • Test different incentive types
  • Make referral prominent in product

If referrals aren't converting:

  • Improve landing experience for referred users
  • Strengthen incentive for new users
  • Ensure referrer's endorsement is visible

A/B Tests to Run

Incentive tests: Amount, type, single vs. double-sided, timing

Messaging tests: Program description, CTA copy, landing page copy

Placement tests: Where and when the referral prompt appears

Common Problems & Fixes

ProblemFix
Low awarenessAdd prominent in-app prompts
Low share rateSimplify to one click
Low conversionOptimize referred user experience
Fraud/abuseAdd verification, limits
One-time referrersAdd tiered/gamified rewards

---

Measuring Success

Key Metrics

Program health:

  • Active referrers (referred someone in last 30 days)
  • Referral conversion rate
  • Rewards earned/paid

Business impact:

  • % of new customers from referrals
  • CAC via referral vs. other channels
  • LTV of referred customers
  • Referral program ROI

Typical Findings

  • Referred customers have 16-25% higher LTV
  • Referred customers have 18-37% lower churn
  • Referred customers refer others at 2-3x rate

---

Launch Checklist

Before Launch

  • [ ] Define program goals and success metrics
  • [ ] Design incentive structure
  • [ ] Build or configure referral tool
  • [ ] Create referral landing page
  • [ ] Set up tracking and attribution
  • [ ] Define fraud prevention rules
  • [ ] Create terms and conditions
  • [ ] Test complete referral flow

Launch

  • [ ] Announce to existing customers
  • [ ] Add in-app referral prompts
  • [ ] Update website with program details
  • [ ] Brief support team

Post-Launch (First 30 Days)

  • [ ] Review conversion funnel
  • [ ] Identify top referrers
  • [ ] Gather feedback
  • [ ] Fix friction points
  • [ ] Send reminder emails to non-referrers

---

Email Sequences

Referral Program Launch

Subject: You can now earn [reward] for sharing [Product]

We just launched our referral program!

Share [Product] with friends and earn [reward] for each signup.
They get [their reward] too.

[Unique referral link]

1. Share your link
2. Friend signs up
3. You both get [reward]

Referral Nurture Sequence

  • Day 7: Remind about referral program
  • Day 30: "Know anyone who'd benefit?"
  • Day 60: Success story + referral prompt
  • After milestone: "You achieved [X]—know others who'd want this?"

---

Affiliate Programs

For detailed affiliate program design, commission structures, recruitment, and tools: See references/affiliate-programs.md

---

Task-Specific Questions

1. What type of program (referral, affiliate, or both)? 2. What's your customer LTV and current CAC? 3. Existing program or starting from scratch? 4. What tools/platforms are you considering? 5. What's your budget for rewards/commissions? 6. Is your product naturally shareable?

---

Tool Integrations

For implementation, see the tools registry. Key tools for referral programs:

ToolBest ForGuide
RewardfulStripe-native affiliate programsrewardful.md
ToltSaaS affiliate programstolt.md
Mention MeEnterprise referral programsmention-me.md
Dub.coLink tracking and attributiondub-co.md
StripePayment processing (for commission tracking)stripe.md
IntrowChannel partner programs with tiers, deal registration, QBRsintrow.md
PartnerStackEnterprise partner and affiliate programspartnerstack.md

---

Related Skills

  • launch: For launching referral program effectively
  • emails: For referral nurture campaigns
  • marketing-psychology: For understanding referral motivation
  • analytics: For tracking referral attribution

Related skills

Forks & variants (2)

Referrals has 2 known copies in the catalog totaling 53 installs. They canonicalize to this original listing.

How it compares

Use referrals for sustained referral/affiliate systems; use launch skill for time-boxed launch virality.

FAQ

What is the difference between a referral and an affiliate program here?

Referral programs have existing customers recommend to their network with limited rewards; affiliate programs use non-customer creators/influencers on ongoing commissions for higher-ticket products.

What metrics does it track?

Active referrers, referral conversion rate, rewards paid, percentage of new customers from referrals, referral CAC, referred-customer LTV, and program ROI.

Is Referrals safe to install?

skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Sales & Marketinglifecycledistribution

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.