referral-program

Name: referral-program
Author: MoizIbnYousaf

27stars5forks

How to install referral-program?

moizibnyousaf/marketing-cli/referral-program

$npx -y skills add MoizIbnYousaf/marketing-cli --skill referral-program

Installs into the current project.

Summary

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'

Files · 1

View on GitHub

SKILL.md

1	# Referral Program Design
2
3	## Purpose
4
5	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.
6
7	## Reads
8
9	- `brand/audience.md` — Personas, what they value, their networks
10	- `brand/positioning.md` — Value props, pricing context for incentive sizing
11	- `brand/voice-profile.md` — Brand voice for all referral copy
12
13	## Brand Integration
14
15	- audience.md — Incentive type depends on audience. B2B audiences prefer account credits. B2C audiences prefer discounts or free months. Developer audiences prefer swag or extended trials.
16	- positioning.md — Referral messaging reinforces the brand's positioning angle, not generic 'share with a friend' copy. If positioning is around simplicity, the referral CTA is 'Know someone drowning in complexity?'
17	- voice-profile.md — All referral copy (dashboard prompts, share text, emails) should match the brand voice. A casual brand writes "Your friend's gonna love this" while a professional brand writes "Share a professional recommendation."
18
19	## Workflow
20
21	### Step 1: Choose Referral Model
22
23	Evaluate and recommend the right model:
24
25	One-Sided (Referrer only gets reward)
26	- Best for: High-value products, enterprise, low-frequency purchases
27	- Pros: Simple, lower cost per referral
28	- Cons: Less motivation for referee to convert
29	- Example: "Give your friend our link, you get $50 credit"
30
31	Two-Sided (Both get reward)
32	- Best for: SaaS, marketplaces, subscription products
33	- Pros: Higher conversion (referee has incentive), feels fair
34	- Cons: Higher cost per referral
35	- Example: "Give $20, get $20"
36
37	Tiered (Rewards increase with referral count)
38	- Best for: Products with power users, community-driven products
39	- Pros: Creates referral champions, gamification
40	- Cons: Complex to communicate, top-heavy rewards
41	- Example: "1 referral = 1 month free. 5 = premium forever."
42
43	Milestone (Unlock rewards at specific counts)
44	- Best for: Products wanting viral moments
45	- Pros: Creates sharing bursts, clear goals
46	- Cons: Can feel like a grind
47	- Example: "3 friends = swag. 10 friends = lifetime access."
48
49	Selection criteria:
50	- Product price point and margins
51	- Customer lifetime value (can you afford the incentive?)
52	- Network effects (does the product get better with more users?)
53	- Purchase frequency (one-time vs recurring)
54
55	### Step 2: Define the Incentive
56
57	#### Incentive Types
58
59	\| Type \| Best When \| Example \|
60	\|------\|-----------\|---------\|
61	\| Account credit \| Recurring subscription \| "$20 off next month" \|
62	\| Extended trial \| Freemium model \| "+7 days of Pro" \|
63	\| Feature unlock \| Gated features exist \| "Unlock advanced analytics" \|
64	\| Cash/gift card \| High LTV, B2B \| "$50 Amazon card" \|
65	\| Discount \| E-commerce, one-time \| "25% off next purchase" \|
66	\| Donation \| Mission-driven brand \| "$10 to charity of choice" \|
67	\| Exclusive access \| Waitlist/beta \| "Skip the waitlist" \|
68	\| Physical swag \| Community brand \| "Free branded merch" \|
69
70	#### Incentive Sizing Rules
71
72	- Referrer reward should be 10-25% of first-year LTV
73	- Referee reward should lower the barrier to first purchase
74	- Two-sided: referee reward can be smaller than referrer reward
75	- Always test: the "right" incentive is discovered, not guessed
76	- Stack with existing promotions cautiously — don't train discount hunters
77
78	### Step 3: Design Sharing Mechanics
79
80	#### Sharing Methods (Offer All, Optimize for Top 2)
81
82	Unique referral link (required, baseline)
83	- Personal URL: `product.com/ref/[username]` or `product.com/r/[code]`
84	- One-click copy button
85	- Auto-populated share text
86
87	Referral code (supplement to link)
88	- Short, memorable: 4-6 characters
89	- Personalizable: user's name or custom code
90	- Easy to share verbally
91
92	Email invite (high-intent channel)
93	- Import contacts option (Google, Outlook)
94	- Or manual email entry
95	- Pre-written message, editable by user
96
97	Social sharing (volume channel)
98	- Twitter/X: Pre-populated tweet with link
99	- LinkedIn: Professional framing for B2B
100	- WhatsApp/SMS: Direct message with link
101	- Platform-native share sheet on mobile
102
103	**

People who liked this also viewed

6 picks

Type

referral-program

27stars5forks

View on GitHub

How to install referral-program?

moizibnyousaf/marketing-cli/referral-program

$npx -y skills add MoizIbnYousaf/marketing-cli --skill referral-program

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Referral Program Design
2
3	## Purpose
4
5	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.
6
7	## Reads
8
9	- `brand/audience.md` — Personas, what they value, their networks
10	- `brand/positioning.md` — Value props, pricing context for incentive sizing
11	- `brand/voice-profile.md` — Brand voice for all referral copy
12
13	## Brand Integration
14
15	- audience.md — Incentive type depends on audience. B2B audiences prefer account credits. B2C audiences prefer discounts or free months. Developer audiences prefer swag or extended trials.
16	- positioning.md — Referral messaging reinforces the brand's positioning angle, not generic 'share with a friend' copy. If positioning is around simplicity, the referral CTA is 'Know someone drowning in complexity?'
17	- voice-profile.md — All referral copy (dashboard prompts, share text, emails) should match the brand voice. A casual brand writes "Your friend's gonna love this" while a professional brand writes "Share a professional recommendation."
18
19	## Workflow
20
21	### Step 1: Choose Referral Model
22
23	Evaluate and recommend the right model:
24
25	One-Sided (Referrer only gets reward)
26	- Best for: High-value products, enterprise, low-frequency purchases
27	- Pros: Simple, lower cost per referral
28	- Cons: Less motivation for referee to convert
29	- Example: "Give your friend our link, you get $50 credit"
30
31	Two-Sided (Both get reward)
32	- Best for: SaaS, marketplaces, subscription products
33	- Pros: Higher conversion (referee has incentive), feels fair
34	- Cons: Higher cost per referral
35	- Example: "Give $20, get $20"
36
37	Tiered (Rewards increase with referral count)
38	- Best for: Products with power users, community-driven products
39	- Pros: Creates referral champions, gamification
40	- Cons: Complex to communicate, top-heavy rewards
41	- Example: "1 referral = 1 month free. 5 = premium forever."
42
43	Milestone (Unlock rewards at specific counts)
44	- Best for: Products wanting viral moments
45	- Pros: Creates sharing bursts, clear goals
46	- Cons: Can feel like a grind
47	- Example: "3 friends = swag. 10 friends = lifetime access."
48
49	Selection criteria:
50	- Product price point and margins
51	- Customer lifetime value (can you afford the incentive?)
52	- Network effects (does the product get better with more users?)
53	- Purchase frequency (one-time vs recurring)
54
55	### Step 2: Define the Incentive
56
57	#### Incentive Types
58
59	\| Type \| Best When \| Example \|
60	\|------\|-----------\|---------\|
61	\| Account credit \| Recurring subscription \| "$20 off next month" \|
62	\| Extended trial \| Freemium model \| "+7 days of Pro" \|
63	\| Feature unlock \| Gated features exist \| "Unlock advanced analytics" \|
64	\| Cash/gift card \| High LTV, B2B \| "$50 Amazon card" \|
65	\| Discount \| E-commerce, one-time \| "25% off next purchase" \|
66	\| Donation \| Mission-driven brand \| "$10 to charity of choice" \|
67	\| Exclusive access \| Waitlist/beta \| "Skip the waitlist" \|
68	\| Physical swag \| Community brand \| "Free branded merch" \|
69
70	#### Incentive Sizing Rules
71
72	- Referrer reward should be 10-25% of first-year LTV
73	- Referee reward should lower the barrier to first purchase
74	- Two-sided: referee reward can be smaller than referrer reward
75	- Always test: the "right" incentive is discovered, not guessed
76	- Stack with existing promotions cautiously — don't train discount hunters
77
78	### Step 3: Design Sharing Mechanics
79
80	#### Sharing Methods (Offer All, Optimize for Top 2)
81
82	Unique referral link (required, baseline)
83	- Personal URL: `product.com/ref/[username]` or `product.com/r/[code]`
84	- One-click copy button
85	- Auto-populated share text
86
87	Referral code (supplement to link)
88	- Short, memorable: 4-6 characters
89	- Personalizable: user's name or custom code
90	- Easy to share verbally
91
92	Email invite (high-intent channel)
93	- Import contacts option (Google, Outlook)
94	- Or manual email entry
95	- Pre-written message, editable by user
96
97	Social sharing (volume channel)
98	- Twitter/X: Pre-populated tweet with link
99	- LinkedIn: Professional framing for B2B
100	- WhatsApp/SMS: Direct message with link
101	- Platform-native share sheet on mobile
102
103	**

People who liked this also viewed

6 picks

Type