Skip to main content
skill CX Codex

referral-program · kostja94 — Claude Code skill: referral program strategy

Walks an agent through referral program design: reward models, link and code mechanics, tracking, and fraud prevention.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add kostja94/marketing-skills --skill referral-program -a claude-code
Open on GitHub

What referral-program does

The skill guides an agent through referral strategy for SaaS and AI products. It starts with context: product type, user base size, and whether the goal is signups or purchases. Then it produces a breakdown covering reward model, mechanism type, attribution, anti-fraud, tool choice, and KPIs.

Comparison tables come built in. Referral versus affiliate versus influencer, three reward models (two-way, one-way, tiered), three mechanisms (link, code, social sharing), four tracking methods. Benchmarks are included too: referral conversion of 3%-5% against 1%-2% for ads, rewards usually 10%-30% of product price.

The skill reads a root contextus.md when present and loads only the modules the task needs. Without it, it falls back to project material or facts you provide. It does not write referral landing copy — that is landing-page-generator territory. Install runs through npx skills add, or gh skill install for GitHub Copilot.

What it helps with

  • pick between two-way and one-way rewards
  • size the reward against product price
  • set an attribution window and first-touch rule
  • block self-referrals and fake accounts
  • decide between self-build and a third-party tool

Example prompts for the agent

  • Plan a referral program for our SaaS: reward model, tracking, anti-fraud
  • Compare link-based and code-based mechanics for a mobile app
  • Which KPIs should we track for a referral program, and how do we set attribution?

How to install referral-program

1Skills CLI (Vercel)

npx skills add kostja94/marketing-skills --skill referral-program -a claude-code

2Manually: put the files in place

~/.claude/skills/referral-program/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/referral-program/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about referral-program

How do I install referral-program in Claude?

Run npx skills add kostja94/marketing-skills --skill referral-program -a claude-code. The skill lands at ~/.claude/skills/referral-program/SKILL.md.

What does referral-program do?

It guides an agent through referral program planning: reward model, mechanism, tracking, fraud prevention, tool selection, and KPIs.

How is a referral program different from an affiliate program?

Referrals come from existing users and need no landing page or application — they sit in the product dashboard. Affiliate programs target professional promoters and require approval.

Source text

SKILL.md · MIT
---
name: referral-program
description: When the user wants to plan, implement, or optimize referral program strategy. Also use when the user mentions "referral program," "referral marketing," "user referral," "refer-a-friend," "word-of-mouth growth," "referral rewards," "referral tracking," "referral code," "referral incentives," or "viral loop." For referral landing copy, use landing-page-generator.
metadata:
  version: 1.0.1
---

# Channels: Referral

Guides referral program strategy for AI/SaaS products. Leverage existing users to drive growth; 3%-5% conversion vs 1%-2% for ads; CAC 50%-70% lower; referred users LTV 30%-50% higher, retention 20%-30% higher. Referral is necessity in overseas markets, not alternative.

**When invoking**: On **first use**, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.

## Initial Assessment

**Project context:** Read root `contextus.md` when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.

Identify:
1. **Product type**: SaaS, AI tool, subscription
2. **User base**: Size, engagement, retention
3. **Goal**: Signups, purchases, or both

## Referral vs. Affiliate vs. Influencer

| Dimension | Referral | Affiliate | Influencer |
|-----------|----------|-----------|------------|
| **Who** | Existing users | Professional promoters | KOLs |
| **Incentive** | Discounts, credits | Commission | Fees, product |
| **Barrier** | Low (all users) | Medium | High |
| **Conversion** | 3%-5% | Varies | Varies |

**Referral vs affiliate**: Referral needs no landing page or application; integrated in dashboard. Affiliate requires landing page and approval.

## Reward Models

| Model | Use |
|-------|-----|
| **Two-way** | Both referrer and referee get rewards; highest participation |
| **One-way** | Only referrer rewarded; cost control |
| **Tiered** | Rewards increase with referral count (e.g. $10 for 1-5, $15 for 6-10, $20 for 11+); incentivizes volume |

**Benchmark**: Rewards typically 10%-30% of product price; ~11% off or ~$21 value; weak incentives = low participation. Triggers: signup, purchase, activation, or sustained use.

## Mechanism Types

| Type | Use |
|------|-----|
| **Link-based** | Unique referral link; easy to implement; accurate tracking; share via email, social, SMS; works for web and app |
| **Code-based** | Referral code (e.g. FRIEND20); memorable; offline events; mobile-friendly input |
| **Social referral** | Share buttons (Facebook, X, LinkedIn); viral spread; friend trust; young users |

## Tracking & Attribution

| Method | Use |
|-------|-----|
| **Cookie** | Web apps; 30-90 day window |
| **URL params** | All platforms; persistent in link |
| **Referral code** | Mobile, offline; manual entry |
| **Account association** | Long-term tracking; subscription products |

**Attribution window**: 30-90 days typical; 180 days for subscription. First-touch attribution to avoid double-counting.

## Fraud Prevention

| Risk | Action |
|------|--------|
| **Self-referral** | Detect same device, payment, IP |
| **Fake accounts** | Validate email, payment; monitor patterns |
| **Bulk/automation** | Rate limits; anomaly detection |
| **Per-user cap** | e.g. Max 10 referrals per user |

Use tool anti-fraud features; audit referrals regularly.

## Design Framework

1. **Reward structure**: Type (cash, discount, credits, free service); amount (10%-30% of price); trigger; cap
2. **Tracking**: Choose method; set attribution window; first-touch rule
3. **UX**: One-click share; clear rules; dashboard with referral data; notify on success
4. **Fraud prevention**: See above
5. **Monitor & optimize**: Referral rate, conversion, CAC, LTV; A/B test rewards and flow

## Best Practices

- **Run multiple programs**: Target different audiences, stages, goals
- **Tiered rewards**: Motivate top performers; progressive incentives
- **Friction-free sharing**: Mobile-friendly; one-click share
- **Time-boxed incentives**: "Refer this week for $15 off" creates urgency
- **Placement**: Web, email, app, in-product touchpoints; dashboard integration primary

## Implementation

| Approach | Use |
|----------|-----|
| **Self-build** | Full control; low cost; URL params or cookie + reward logic + fraud checks; open-source (e.g. RefRef) for faster start |
| **Third-party** | Fast launch; Cello, Viral Loops, ReferralCandy (e-commerce), Impact (enterprise); monthly fee |

**Placement**: Most programs integrate in product dashboard; no landing page or application needed. Optional landing page for value prop, rewards, and case studies.

**Startup cost**: Typically hundreds for tools + dev.

## Tools

| Tool | Use |
|------|-----|
| **Cello** | SaaS; AI-driven automation |
| **Viral Loops** | Referral + waitlist + contests |
| **ReferralCandy** | Shopify, e-commerce |
| **Impact** | Enterprise; unified platform |
| **RefRef** | Open-source; self-hosted |

## KPIs

Referral rate, conversion, CAC, LTV of referred users, referred-user retention.

## Output Format

- **Reward model** and mechanism type (link/code/social)
- **Tracking** approach and attribution window
- **Placement** (dashboard vs landing page)
- **Fraud prevention** measures
- **Tool** selection (self-build vs third-party)
- **KPI** framework

## Related Skills

- **discount-marketing-strategy**: Referral rewards (discounts, credits); 10–30% benchmark; campaign design
- **affiliate-marketing**: Different audience; can run both
- **influencer-marketing**: Brand building vs. user-driven growth
- **directory-submission**: Directory submission for discovery; referral for user-driven growth
- **analytics-tracking**: Referral link tracking, UTM

© kostja94 · MIT · kostja94/marketing-skills

Similar skills

Everything for Marketing and content →

referral-program by other authors comes first.

referral-program Alireza Rezvani Plans referral or affiliate programs and diagnoses weak points in an existing referral loop. 587installs referral-program appeeky Plans an in-app referral programme with reward rules, invite flows, fraud controls and K-factor measurement. CX Codex +1 1,700installs referral-program OpenClaudia Guides AI agents in designing referral programs and viral loops. It covers incentive structures, viral coefficient math, and invite copy. CX Codex +1 421installs referral-abuse-guardrails Maya-Beth Finotti Writes the rules that keep customers from farming refer-a-friend rewards: caps, payout holds, verification gates and an enforcement ladder. CX Codex +1 13,100installs growth-loops phuryn The growth-loops skill helps identify and design growth loops for your product. Evaluates five loop types, from viral to referral. CX Codex +1 2,900installs retention-engagement RefoundAI Helps identify user churn drivers, track cohort survival curves, and introduce habit mechanics like streaks. Useful when onboarding friction causes early drop-off. CX Codex +1 2,200installs referrals coreyhaines31 A skill that walks an agent through designing, optimizing and measuring a referral, affiliate or word-of-mouth program. Useful when existing users should bring in new ones. CX Codex +1 72,000installs grow-business wondelai Walks you through nine phases from lumpy revenue to a repeatable growth engine, recording every decision in docs/. CX Codex +1 2,200installs advocacy-program-designer aaron-he-zhu Blueprints employee and founder advocacy programs with anti-pod safeguards. Prepares staggered posting schedules, personalized share kits, and regulatory disclosure lines. CX Codex +1 1,000installs

From the same set125

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor