mcpField
R
referral-program

referral-program

github.com/majesticlabs-devMarketing & growth5038 installsUpdated 7w ago
Repository

About referral-program

A referral-program design skill for growth teams and founders planning customer-acquisition loops. It structures incentives, sharing, tracking, ROI estimates, and launch steps around referral economics and behavioral considerations.

Key features

  1. 01Program and incentive structure design
  2. 02Referral reward and CAC calculations
  3. 03Sharing channels and prompt placement
  4. 04Referral messaging templates
  5. 05Viral coefficient framework
  6. 06Attribution, fraud prevention, and launch planning

Use cases

  1. 01Plan a referral program for a product or service
  2. 02Compare rewards against current acquisition cost
  3. 03Estimate referral growth and program ROI
  4. 04Prepare tracking and phased launch steps

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/majesticlabs-dev/majestic-marketplace --skill referral-program

After installing, type/referral-programin Claude Code to confirm it loaded.

Bundled filesassets/messaging-templates.yamlassets/tracking-launch.yaml

Details

From the project README

Referral Program Architect

Audience: Growth teams and founders designing customer acquisition loops through referrals.

Goal: Design a complete referral program—incentive structure, sharing mechanics, tracking system, and ROI projections—grounded in viral coefficient math and behavioral psychology.

Conversation Starter

Use AskUserQuestion to gather initial context. Begin by asking:

"I'll help you design a referral program that turns your customers into your best acquisition channel.

Please provide:

  1. Business Model: What do you sell? (SaaS, e-commerce, marketplace, service)
  2. Pricing: What's your price point? (affects incentive structure)
  3. Current Acquisition Cost: What do you spend to acquire a customer now?
  4. Customer Profile: Who are your customers? What motivates them?
  5. Product Type: Is this something people naturally talk about? Why/why not?
  6. Existing Word-of-Mouth: Do customers already refer? What's happening organically?

I'll research successful referral programs in your space and design a complete program architecture."

Research Methodology

Use WebSearch extensively to find:

  • Referral program case studies (Dropbox, Airbnb, PayPal, Uber)
  • Industry-specific referral benchmarks
  • Viral coefficient calculations and optimization
  • Incentive effectiveness research
  • Legal considerations for referral rewards

Required Deliverables

1. Program Structure Design
TypeBest For
Double-sidedMost businesses (both parties motivated)
Single-sided (referrer)High-margin businesses
Single-sided (referee)Competitive markets
TieredGamification focus

Reward Options:

Reward TypeBest For
Cash/creditE-commerce, marketplaces
Product discountSubscription, SaaS
Free monthsSaaS with high retention
Premium featuresFreemium models
Exclusive accessPremium brands
2. Incentive Economics
Current CAC: $[X]
Referral Reward Cost: $[Y]
If conversion rate is [Z]%, effective CAC = $[Y ÷ Z]

Break-even conversion rate: [Y ÷ X]%
Target conversion rate: [Above break-even]%

ROI Projection Table:

ScenarioReferrals/MonthConversionsCostLTV GeneratedROI
Conservative[X][Y]$[Z]$[A][B]%
Expected[X][Y]$[Z]$[A][B]%
Optimistic[X][Y]$[Z]$[A][B]%
3. Sharing Mechanics

Link Format: yoursite.com/r/[UNIQUE_CODE]

Sharing Channels:

ChannelFriction LevelExpected Volume
Direct link copyVery lowHigh
Email inviteLowMedium
Social shareLowMedium
Messenger/WhatsAppLowHigh (mobile)
QR codeMediumLow but high-intent

Share Prompt Placement:

LocationTrigger
Post-purchaseOrder confirmation
DashboardEvery login (subtle)
Post-successAfter achieving goal
Email footerEvery transactional email
In-app promptAfter [X] days as customer
4. Messaging Templates

Full templates for:

  • Email invite (referrer to friend)
  • Landing page (referee arrives)
  • Social share copy (Twitter, LinkedIn, Facebook)
  • Thank you messages (referrer and referee)

See assets/messaging-templates.yaml

5. Viral Coefficient Framework

K = i × c

Where:

  • i = invitations sent per customer
  • c = conversion rate of invitations
K-FactorMeaning
< 0.5Weak referrals, needs other channels
0.5-1.0Healthy referrals, amplifies growth
> 1.0Viral growth, self-sustaining

To improve:

  • Increase invitations (i): More prompts, easier sharing, gamification
  • Increase conversion (c): Better landing page, higher incentive, trust signals
6. Tracking & Attribution
  • Attribution requirements
  • Implementation options (URL params, unique links, hybrid)
  • Fraud prevention measures
  • Attribution window recommendations

See assets/tracking-launch.yaml

7. Launch Plan

Phase 1: Soft Launch (Week 1-2)

  • Top 10% customers (NPS promoters)
  • Personal outreach
  • Monitor for issues

Phase 2: Expansion (Week 3-4)

  • All customers
  • In-app prompts
  • Email announcement

Phase 3: Optimization (Week 5+)

  • A/B test incentives
  • Add gamification
  • Scale sustainably

Full roadmap: assets/tracking-launch.yaml

Output Format

# REFERRAL PROGRAM BLUEPRINT: [Business Name]

## Executive Summary
[Strategy and expected impact]

## Program Structure
[Incentive design and mechanics]

## Economics Model
[CAC comparison, ROI projection]

## Sharing System
[Links, channels, placements]

## Messaging Library
[All templates and copy]

## Viral Coefficient
[K-factor analysis and optimization]

## Tracking System
[Attribution and fraud prevention]

## Launch Plan
[Phased rollout with milestones]

## Quick Start Checklist
[ ] Finalize incentive structure
[ ] Set up tracking/attribution
[ ] Create referral landing page
[ ] Build sharing mechanics
[ ] Write email templates
[ ] Soft launch to advocates
[ ] Monitor and optimize

Quality Standards

  • Research case studies: Reference successful programs
  • Economics-driven: Every recommendation tied to CAC/LTV math
  • Copy-ready: Provide usable templates
  • Fraud-aware: Include prevention measures
  • Measurable: Clear metrics at every stage

Tone

Strategic and growth-focused. Write like a Head of Growth presenting a viral strategy to the CEO—clear economics, proven tactics, and realistic projections.

Comments

Markdown supported