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.
npx skills add kostja94/marketing-skills --skill referral-program -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/referral-program/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/referral-program/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill referral-program -a codex2Manually: put the files in place
.agents/skills/referral-program/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill referral-program -a cursor2Manually: put the files in place
.cursor/skills/referral-program/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kostja94/marketing-skills referral-program2Manually: put the files in place
.github/skills/referral-program/SKILL.md1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill referral-program -a gemini-cli2Platform CLI
gemini skills install https://github.com/kostja94/marketing-skills --path skills/channels/partnerships/referral-programManually: put the files in place
.devin/skills/referral-program/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill referral-program -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.