Skip to content

/referrals

When the user wants referral and affiliate programs or word of mouth, or asks what to reward, how much to pay, or which loop to start with: refer-a-friend incentives, commissions and payouts, partner programs, 'made with' badges, review campaigns. For launch virality, see

From plugin
marketing-skills
60k53 skills

Claude Code

$ npx -y skills add coreyhaines31/marketingskills --skill referrals --agent claude-code

SKILL.md

referrals.SKILL.md
name: referrals
description: "When the user wants referral and affiliate programs or word of mouth, or asks what to reward, how much to pay, or which loop to start with: refer-a-friend incentives, commissions and payouts, partner programs, 'made with' badges, review campaigns. For launch virality, see launch. For creator deals, see influencer-marketing."
metadata:
  version: 2.2.4

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?

---

Should You Engineer Virality First?

Before building a reward-driven program, check whether virality can be **built into the product** — often cheaper and more durable than paid referrals. But **don't force virality where it doesn't naturally fit.**

Place the product on the **Viral Potential Spectrum**:

  • **Natural** (build for it): collaboration tools, communication tools, user-facing outputs — every use exposes the product to non-users.
  • **Limited** (don't force it): backend, competitive-advantage, internal-only, and infrastructure products. Invest in referral programs, content, and partnerships instead.

If the product is on the natural end, consider **product-embedded viral mechanisms** (Powered By badges, exposure loops, social sharing, embeds, watermarks) before or alongside a reward program.

**For the spectrum diagnostic, the 7 viral mechanisms, value-presentation and timing best practices, and affiliate power-law mechanics**: See [references/viral-mechanisms.md](references/viral-mechanisms.md)

---

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

For partner recruitment/activation, cohort economics, executable terms, reconciliation, and measured incremental growth, load [the operating playbook](references/affiliate-operations.md). This expands the existing affiliate branch instead of creating an overlapping skill.

**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

**Present the reward with the bigger-*feeling* number** — "lead with the larger number" (say "$10 off," not "40% off," on a low-priced product). Reward at the **aha moment or milestone**, not signup. Reduce friction: one-click share, pre-written messages.

**For examples and incentive sizing**: See [references/program-examples.md](references/program-examples.md)

**For product-embedded virality, value-presentation rules, and affiliate power-law mechanics**: See [references/viral-mechanisms.md](references/viral-mechanisms.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 verification, limits | | One-time referrers | Add tiered/gamified rewards |

---

Measuring Success

Key Metrics

**Program health:**

  • Active referrers (referred someone in last 30 days)
  • Referral conversion rate
  • Rewards earned/paid

**Business impact:**

  • % of new customers from referrals
  • CAC via referral vs. other channels
  • LTV of referred customers
  • Referral program ROI

Typical Findings

  • Referred customers
Read more
@coreyhaines31
Ships withmarketing-skills

A collection of AI agent skills focused on marketing tasks. Built for technical marketers and founders who want AI coding agents to help with conversion optimization, copywriting, SEO, analytics, and growth engineering.

Stars on GitHub

Momentum

stars in total
60.0k
Star history of coreyhaines31/marketingskills on GitHub, a chart by star-history.com

Other skills on marketing-skills.

ab-testing
Auto-invoked

ab-testing

When the user wants to plan, run, or read A/B tests, or asks a judgement call on one: is the result real, can we stop, which…

ad-creative
Auto-invoked

ad-creative

When the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and…

ads
Auto-invoked

ads

When the user wants to plan, run, or fix paid ads on Google, Meta, and LinkedIn, or asks a judgement call on them: are ads worth…

ai-seo
Auto-invoked

ai-seo

When the user wants to get cited and recommended in AI answers (ChatGPT, Perplexity, AI Overviews), or asks why AI cites a…

analytics
Auto-invoked

analytics

When the user wants to set up or audit analytics, or asks whether a metric or number is calculated right, what to track, or how…

aso
Auto-invoked

aso

When the user wants to audit or optimize an App Store or Google Play listing, or asks which title, keywords, or screenshots to…

More skills from other plugins.

seo

seo

Comprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability,…

@agricidaniel@agricidanielInstall Skill
brag

brag

Turn the current project website into a short, polished, shareable launch video using Hyperframes. Use when someone says "/brag",…

brag3w21k
@latent-spaces@latent-spacesInstall Skill
geo-audit

geo-audit

Full website GEO+SEO audit with parallel subagent delegation. Orchestrates a comprehensive Generative Engine Optimization audit…

scroll-world

scroll-world

Build an immersive scroll-scrubbed "fly through the world" landing page for any industry or brand using Higgsfield. As the…

@oso95@oso95Install Skill

Questions about referrals.

Which coding agents can use referrals?
referrals installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.