Best for
- Design a referral program that turns existing users into an acquisition channel. Define the incentive model, sharing mechanics, copy, and launch plan. Focus on programs that actually get used — not "refer a friend" link…
MoizIbnYousaf/marketing-cli/skills/referral-program/SKILL.md
Designs viral referral programs with incentive structures, sharing mechanics, and tracking. Covers one-sided, two-sided, tiered, and milestone models with viral coefficient calculations. Use when someone wants word-of-mouth growth, viral loops, invite programs, or says 'referral', 'viral loop', 'word of mouth', 'invite program', 'refer a friend', 'growth loop', 'referral incentive', 'affiliate program', 'ambassador program', 'get users to invite friends', or 'organic growth'. Even casual mention
Decision brief
Designs viral referral programs with incentive structures, sharing mechanics, and tracking. Covers one-sided, two-sided, tiered, and milestone models with viral coefficient calculations.
Compatibility matrix
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill "skills/referral-program"Inspect the Agent Skill "referral-program" from https://github.com/MoizIbnYousaf/marketing-cli/blob/f12fbcbe4929584697b309b9096c9427b0cfce8e/skills/referral-program/SKILL.md at commit f12fbcbe4929584697b309b9096c9427b0cfce8e. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
Evaluate and recommend the right model:
Evaluate and recommend the right model:
Referrer reward should be 10-25% of first-year LTV
Unique referral link (required, baseline) - Personal URL: product.com/ref/[username] or product.com/r/[code] - One-click copy button - Auto-populated share text
Post-achievement trigger:
Permission review
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 81/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 27 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Design a referral program that turns existing users into an acquisition channel. Define the incentive model, sharing mechanics, copy, and launch plan. Focus on programs that actually get used — not "refer a friend" links that collect dust.
brand/audience.md — Personas, what they value, their networksbrand/positioning.md — Value props, pricing context for incentive sizingbrand/voice-profile.md — Brand voice for all referral copyEvaluate and recommend the right model:
One-Sided (Referrer only gets reward)
Two-Sided (Both get reward)
Tiered (Rewards increase with referral count)
Milestone (Unlock rewards at specific counts)
Selection criteria:
| Type | Best When | Example |
|---|---|---|
| Account credit | Recurring subscription | "$20 off next month" |
| Extended trial | Freemium model | "+7 days of Pro" |
| Feature unlock | Gated features exist | "Unlock advanced analytics" |
| Cash/gift card | High LTV, B2B | "$50 Amazon card" |
| Discount | E-commerce, one-time | "25% off next purchase" |
| Donation | Mission-driven brand | "$10 to charity of choice" |
| Exclusive access | Waitlist/beta | "Skip the waitlist" |
| Physical swag | Community brand | "Free branded merch" |
Unique referral link (required, baseline)
product.com/ref/[username] or product.com/r/[code]Referral code (supplement to link)
Email invite (high-intent channel)
Social sharing (volume channel)
In-product prompts (highest conversion trigger)
Dashboard prompt:
Give [incentive], Get [incentive]
Share [Product] with friends and you both get rewarded.
You've earned [X] so far from [Y] referrals.
[Copy Your Link] [Invite by Email]
Post-achievement trigger:
Nice — you just [achievement]!
Know someone who'd love this too?
Share your link and you both get [incentive].
[Share Now] [Maybe Later]
Email nudge:
Subject: You have $[X] in referral rewards waiting
You've been using [Product] for [X] weeks and
[specific achievement]. Know someone who'd benefit?
Share your personal link and you both get [incentive]:
[referral link]
[Share via Email] [Copy Link]
Referral landing page:
[Referrer name] invited you to [Product]
[Referrer] thinks you'd love [Product] — and they're
giving you [incentive] to try it.
[What Product Does — one sentence]
[Claim Your [Incentive]]
[Social proof: X users, rating, testimonial]
Referee welcome email:
Subject: [Referrer] gifted you [incentive] for [Product]
Welcome! [Referrer name] shared [Product] with you
and you've got [incentive] waiting.
Here's how to get started:
1. [Quick start step]
2. [Quick start step]
3. [Quick start step]
[Get Started with [Incentive]]
Viral Coefficient (K) = i x c
i = invitations sent per user
c = conversion rate of invitations
K > 1 = viral growth (each user brings >1 new user)
K = 0.5 = healthy referral supplement
K < 0.2 = program needs work
Example:
- Average user sends 5 invites
- 15% of invites convert
- K = 5 x 0.15 = 0.75 (strong, not viral)
To improve K:
- Increase i: More sharing triggers, easier sharing mechanics
- Increase c: Better referee landing page, stronger incentive
| Metric | Formula | Healthy Range |
|---|---|---|
| Participation rate | Users who shared / Total users | 10-25% |
| Shares per user | Total shares / Participating users | 3-8 |
| Invite conversion rate | Signups / Total shares | 10-25% |
| Referral revenue % | Referred revenue / Total revenue | 15-35% |
| Time to first referral | Avg days from signup to first share | <30 days |
| Viral coefficient | Invites x Conversion rate | >0.3 |
| Referral CAC | Program cost / Referred customers | <Paid CAC |
Each referral program design produces:
Alternatives
MoizIbnYousaf/marketing-cli
Use when the user wants to generate an image or video via Higgsfield AI. Covers 30+ models: Soul V2, Seedance 2.0, Kling 3.0, Veo 3.1, GPT Image 2, Nano Banana 2. Also covers Marketing Studio — branded ad video/image with avatars and products. Use whenever: "generate an image", "make a video", "animate this photo", "image-to-video", "img2vid", "edit this image with AI", "produce a clip", "create an ad", "make a UGC video", "marketing video", "brand video", "TV spot", "import product from URL", "
wshobson/agents
Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens —
coreyhaines31/marketingskills
When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold out
JasonColapietro/suede-creator-skills
Umbrella workflow for 67 public skills: Full Send, copy, design, code review, SEO, launch packaging, MCP QA, iOS and Android app shipping, and creator workflows. Loads the full public skill pack.