skills/coreyhaines31/referral-program/SKILL.md
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' or 'partner program.' This skill covers program design, incentive structure, and growth optimization.
npx skillsauth add aiskillstore/marketplace referral-programInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are an expert in viral growth and referral marketing with access to referral program data and third-party tools. Your goal is to help design and optimize programs that turn customers into growth engines.
Gather this context (ask if not provided):
Best for:
Characteristics:
Best for:
Characteristics:
Many successful programs combine both:
┌─────────────────────────────────────────────────────┐
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Trigger │───▶│ Share │───▶│ Convert │ │
│ │ Moment │ │ Action │ │ Referred │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ ▲ │ │
│ │ │ │
│ └───────────────────────────────┘ │
│ Reward │
└─────────────────────────────────────────────────────┘
When are customers most likely to refer?
High-intent moments:
Natural sharing moments:
Methods ranked by effectiveness:
Best practice: Offer multiple sharing options, lead with the highest-converting method.
Single-sided rewards (referrer only):
Double-sided rewards (both parties):
Tiered rewards:
| Type | Pros | Cons | Best For | |------|------|------|----------| | Cash/credit | Universally valued | Feels transactional | Marketplaces, fintech | | Product credit | Drives usage | Only valuable if they'll use it | SaaS, subscriptions | | Free months | Clear value | May attract freebie-seekers | Subscription products | | Feature unlock | Low cost to you | Only works for gated features | Freemium products | | Swag/gifts | Memorable, shareable | Logistics complexity | Brand-focused companies | | Charity donation | Feel-good | Lower personal motivation | Mission-driven brands |
Calculate your maximum incentive:
Max Referral Reward = (Customer LTV × Gross Margin) - Target CAC
Example:
Typical referral rewards:
Program: Give 500MB storage, get 500MB storage Why it worked:
Program: Give $10 ride credit, get $10 when they ride Why it worked:
Program: Tiered rewards for subscriber referrals
Why it worked:
Program: $10 credit per referral (education) Why it worked:
Percentage of sale:
Flat fee per action:
Recurring commission:
Tiered commission:
How long after click does affiliate get credit?
| Duration | Use Case | |----------|----------| | 24 hours | High-volume, low-consideration purchases | | 7-14 days | Standard e-commerce | | 30 days | Standard SaaS/B2B | | 60-90 days | Long sales cycles, enterprise | | Lifetime | Premium affiliate relationships |
Where to find affiliates:
Outreach template:
Subject: Partnership opportunity — [Your Product]
Hi [Name],
I've been following your content on [topic] — particularly [specific piece] — and think there could be a great fit for a partnership.
[Your Product] helps [audience] [achieve outcome], and I think your audience would find it valuable.
We offer [commission structure] for partners, plus [additional benefits: early access, co-marketing, etc.].
Would you be open to learning more?
[Your name]
Provide affiliates with:
Viral coefficient (K-factor):
K = Invitations × Conversion Rate
K > 1 = Viral growth (each user brings more than 1 new user)
K < 1 = Amplified growth (referrals supplement other acquisition)
Example:
Referral rate:
Referral Rate = (Customers who refer) / (Total customers)
Benchmarks:
Referrals per referrer:
How many successful referrals does each referring customer generate?
Benchmarks:
Referral Program ROI = (Revenue from referred customers - Program costs) / Program costs
Program costs = Rewards paid + Tool costs + Management time
Track separately:
If few customers are referring:
If referrals aren't converting:
Incentive tests:
Messaging tests:
Placement tests:
| Problem | Likely Cause | Fix | |---------|--------------|-----| | Low awareness | Program not visible | Add prominent in-app prompts | | Low share rate | Too much friction | Simplify to one click | | Low conversion | Weak landing page | Optimize referred user experience | | Fraud/abuse | Gaming the system | Add verification, limits | | One-time referrers | No ongoing motivation | Add tiered/gamified rewards |
Technical:
Policy:
Structural:
Full-featured platforms:
Built-in options:
Affiliate networks:
Self-hosted:
Consider:
Email 1: Announcement
Subject: You can now earn [reward] for sharing [Product]
Body:
We just launched our referral program!
Share [Product] with friends and earn [reward] for each person who signs up. They get [their reward] too.
[Unique referral link]
Here's how it works:
1. Share your link
2. Friend signs up
3. You both get [reward]
[CTA: Share now]
After signup (if they haven't referred):
Subject: Your friends are loving [Product]
Body:
Remember when you referred [Name]? They've [achievement/milestone].
Know anyone else who'd benefit? You'll earn [reward] for each friend who joins.
[Referral link]
Program health:
Business impact:
Track referred customers separately:
Typical findings:
If you need more context:
development
Apple Human Interface Guidelines for content display components. Use this skill when the user asks about charts component, collection view, image view, web view, color well, image well, activity view, lockup, data visualization, content display, displaying images, rendering web content, color pickers, or presenting collections of items in Apple apps. Also use when the user says how should I display charts, what's the best way to show images, should I use a web view, how do I build a grid of items, what component shows media, or how do I present a share sheet. Cross-references: hig-foundations for color/typography/accessibility, hig-patterns for data visualization patterns, hig-components-layout for structural containers, hig-platforms for platform-specific component behavior.
tools
Automate HelpDesk tasks via Rube MCP (Composio): list tickets, manage views, use canned responses, and configure custom fields. Always search tools first for current schemas.
testing
Expert Haskell engineer specializing in advanced type systems, pure functional design, and high-reliability software. Use PROACTIVELY for type-level programming, concurrency, and architecture guidance.
tools
GraphQL gives clients exactly the data they need - no more, no less. One endpoint, typed schema, introspection. But the flexibility that makes it powerful also makes it dangerous. Without proper controls, clients can craft queries that bring down your server. This skill covers schema design, resolvers, DataLoader for N+1 prevention, federation for microservices, and client integration with Apollo/urql. Key insight: GraphQL is a contract. The schema is the API documentation. Design it carefully.