
Referrals
Design or tune customer referral, affiliate, and word-of-mouth programs with incentives aligned to LTV, CAC, and product shareability.
Overview
referrals is an agent skill most often used in Grow (also Launch distribution contexts) that designs and optimizes referral, affiliate, and word-of-mouth growth programs.
Install
npx skills add https://github.com/coreyhaines31/marketingskills --skill referralsWhat is this skill?
- Frames customer referral vs affiliate programs with B2B/B2C and LTV versus CAC context
- Pulls product-marketing context from .agents/product-marketing.md when present before questioning
- Audits program type, current referral rate, incentives tried, and product shareability
- Covers viral loops, refer-a-friend flows, partner programs, and payout design
- Points to launch skill for launch-specific virality when timing is pre-scale
- product-marketing context check: .agents/product-marketing.md or legacy filenames
Adoption & trust: 14.4k installs on skills.sh; 32.4k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You rely on paid channels but lack a structured referral or affiliate program matched to LTV, CAC, and how shareable your product really is.
Who is it for?
Bootstrapped SaaS or consumer products with happy users who could invite others if incentives and flows were intentional.
Skip if: Pre-product ideation with no customers to refer, or launch-only splash campaigns—use launch-oriented skills for release virality.
When should I use this skill?
User wants referral, affiliate, ambassador, word-of-mouth, viral loop, refer a friend, partner program, or referral incentive strategy; not launch-only virality without ongoing program design.
What do I get? / Deliverables
After the skill runs, you have a clarified program type, incentive strategy, and optimization checklist aligned to referral rate and product-fit constraints.
- Referral or affiliate program structure
- Incentive and economics recommendations
- Context-driven discovery answers documented
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Referral program design is shelved under Grow because it compounds users through lifecycle incentives after the product exists. Lifecycle subphase fits ongoing referral loops, ambassador payouts, and retention-driven viral mechanics—not one-off launch stunts alone.
Where it fits
Tune refer-a-friend rewards after onboarding when power users already invite teammates informally.
Model referral rate and CAC payback before increasing affiliate commissions.
Sketch ambassador tiers for early adopters without conflating launch buzz with long-term referral ops.
Sanity-check whether referral credits fit LTV before committing to generous dual-sided incentives.
How it compares
Use for ongoing referral and affiliate program design, not generic SEO content briefs or ad creative generation.
Common Questions / FAQ
Who is referrals for?
Solo builders and indie founders who want existing users or partners to bring new customers via referral, affiliate, or ambassador programs.
When should I use referrals?
Use in Grow when optimizing lifecycle referrals and partner payouts; also when planning word-of-mouth after launch, or analyzing why referral rate is low—see launch skills for release-specific virality.
Is referrals safe to install?
It is advisory marketing guidance without mandatory third-party installs; review the Security Audits panel on this page before connecting payout or tracking tools it may suggest.
SKILL.md
READMESKILL.md - Referrals
# 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](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 | Problem | Fix | |---------|-----| | Low awareness | Add prominent in-app prompts | | Low share rate | Simplify to one click | | Low conversion | Optimize referred user experience | | Fraud/abuse | Add