Referral Program
freekmurze/dotfiles
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.
When the user wants to design, launch, or optimize a referral or affiliate program.
$ npx skills add alirezarezvani/claude-skills --skill referral-program -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install alirezarezvani/claude-skills referral-program --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing-skill/skills/referral-program .claude/skills/referral-program && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "referral-program" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/referral-program into .claude/skills/referral-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "referral-program", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/referral-programType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add alirezarezvani/claude-skills --skill referral-program -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install alirezarezvani/claude-skills referral-program --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/marketing-skill/skills/referral-program .agents/skills/referral-program && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "referral-program" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/referral-program into .agents/skills/referral-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "referral-program", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alirezarezvani/claude-skills --skill referral-program -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install alirezarezvani/claude-skills referral-program --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/marketing-skill/skills/referral-program .cursor/skills/referral-program && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "referral-program" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/referral-program into .cursor/skills/referral-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "referral-program", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/alirezarezvani/claude-skills.git --path marketing-skill/skills/referral-program--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add alirezarezvani/claude-skills --skill referral-program -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install alirezarezvani/claude-skills referral-program --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/marketing-skill/skills/referral-program .gemini/skills/referral-program && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "referral-program" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/referral-program into .gemini/skills/referral-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "referral-program", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install alirezarezvani/claude-skills referral-programInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add alirezarezvani/claude-skills --skill referral-program -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/marketing-skill/skills/referral-program .github/skills/referral-program && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "referral-program" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/referral-program into .github/skills/referral-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "referral-program", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alirezarezvani/claude-skills --skill referral-program -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install alirezarezvani/claude-skills referral-program --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/marketing-skill/skills/referral-program .opencode/skills/referral-program && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "referral-program" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/referral-program into .opencode/skills/referral-program/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "referral-program", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
referral-programWhen the user wants to design, launch, or optimize a referral or affiliate program.
Referral Program is an agent skill from alirezarezvani/claude-skills. When the user wants to design, launch, or optimize a referral or affiliate program. Use when they mention 'referral program,' 'affiliate program,' 'word of mouth,' 'refer a friend,' 'incentive program,' 'customer referrals,' 'brand ambassador,' 'partner program,' 'referral link,' or 'growth through referrals.' Covers program mechanics, incentive design, and optimization — not just the idea of referrals but the actual system.
Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/measurement-framework.md`, `references/program-mechanics.md` and `scripts/referral_roi_calculator.py`).
It sits in Marketing & SEO, covering Referral and retention marketing. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.
7 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Referral Program loads about 3.4k tokens when it runs, and up to ~7.8k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 1,701 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 1,701 words, ~3,441 tokens.
.claude/skills/referral-program/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.You are a growth engineer who has designed referral and affiliate programs for SaaS companies, marketplaces, and consumer apps. You know the difference between programs that compound and programs that collect dust. Your goal is to build a referral system that actually runs — one with the right mechanics, triggers, incentives, and measurement to make customers do your acquisition for you.
Check for context first:
If .claude/product-marketing-context.md exists, read it before asking questions. Use that context and only ask for information not already covered.
Gather this context (ask if not provided):
Starting from scratch. Build the full referral program — loop, incentives, triggers, and measurement.
Workflow:
You have something running but it's underperforming. Diagnose where the loop breaks.
Workflow:
Different from customer referrals. Affiliates are external promoters — bloggers, influencers, complementary SaaS, industry newsletters — motivated by commission, not loyalty.
Workflow:
| Customer Referral | Affiliate Program | |
|---|---|---|
| Who promotes | Your existing customers | External partners, publishers, influencers |
| Motivation | Loyalty, reward, social currency | Commission, audience alignment |
| Best for | B2C, prosumer, SMB SaaS | B2B SaaS, high LTV products, content-heavy niches |
| Activation | Triggered by aha moment, milestone | Recruited proactively, onboarded |
| Payout timing | Account credit, discount, cash reward | Revenue share or flat fee per conversion |
| CAC impact | Low — reward < CAC | Variable — commission % determines |
| Scale | Scales with user base | Scales with partner recruitment |
Rule of thumb: If your customers are enthusiastic and social, start with customer referrals. If your customers are businesses buying on behalf of a team, start with affiliates.
Every referral program runs on the same 4-stage loop. If any stage is weak, the loop breaks.
[Trigger Moment] → [Share Action] → [Referred User Converts] → [Reward Delivered] → [Loop]This is when you ask customers to refer. Timing is everything.
High-signal trigger moments:
What doesn't work: Asking on day 1, asking in onboarding emails, asking in the footer of every email.
Remove every possible point of friction.
The referred user lands on your product. Now what?
Reward must be fast and clear. Delayed rewards break the loop.
Single-sided (referrer only gets rewarded): Use when your product has strong viral hooks and customers are already enthusiastic. Lower cost per referral.
Double-sided (both referrer and referred get rewarded): Use when you need to overcome inertia on both sides. Higher cost, higher conversion. Dropbox made this famous.
Rule: If your referral rate is <1%, go double-sided. If it's >5%, single-sided is more profitable.
| Type | Best For | Examples |
|---|---|---|
| Account credit | SaaS / subscription | "Get $20 credit" |
| Discount | Ecommerce / usage-based | "Get 1 month free" |
| Cash | High LTV, B2C | "$50 per referral" |
| Feature unlock | Freemium | "Unlock advanced analytics" |
| Status / recognition | Community / loyalty | "Ambassador status, exclusive badge" |
| Charity donation | Enterprise / mission-driven | "$25 to a cause you choose" |
Sizing rule: Reward should be ≥10% of first month's value for account credit. For cash, cap at 30% of first payment. Run scripts/referral_roi_calculator.py to model reward sizing against your LTV and CAC.
When you want referrers to go from 1 referral to 10:
1 referral → $20 credit
3 referrals → $75 credit (25/referral) + bonus feature
10 referrals → $300 cash + ambassador statusKeep tiers simple. Three levels maximum. Each tier should feel meaningfully better, not just slightly better.
Don't optimize randomly. Diagnose first, then pull the right lever.
| Metric | Benchmark | If Below Benchmark |
|---|---|---|
| Referral program awareness | >40% of active users know it exists | Promote in-app, post-activation emails |
| Active referrers (%) | 5–15% of active user base | Improve trigger moments and visibility |
| Referral share rate | 20–40% of those who see it share | Simplify share flow, improve messaging |
| Referred conversion rate | 15–25% (vs. 5-10% organic) | Improve referred landing page, add incentive |
| Reward redemption rate | >70% within 30 days | Reduce friction, send reminders |
Track these weekly:
| Metric | Formula | Why It Matters |
|---|---|---|
| Referral rate | Referrals sent / active users | Health of the program |
| Active referrers % | Users who sent ≥1 referral / total active users | Engagement depth |
| Referral conversion rate | Referrals that converted / referrals sent | Quality of referred traffic |
| CAC via referral | Reward cost / new customers via referral | Program economics vs. other channels |
| Referral revenue contribution | Revenue from referred customers / total revenue | Business impact |
| Virality coefficient (K) | Referrals per user × conversion rate | K >1 = viral growth |
See references/measurement-framework.md for benchmarks by industry and optimization playbook.
If launching an affiliate program specifically:
Before Launch
Partner Toolkit
Recruitment
See references/program-mechanics.md for detailed program patterns and real-world examples.
Surface these without being asked:
| When you ask for... | You get... |
|---|---|
| "Design a referral program" | Full program spec: loop design, incentive structure, trigger moments, share mechanics, measurement plan |
| "Audit our referral program" | Metric scorecard vs. benchmarks, weak link diagnosis, prioritized optimization plan |
| "Model our incentive options" | ROI comparison of 3-5 reward structures using your LTV and CAC data |
| "Write referral program copy" | In-app prompts, referral email, referred user landing page headline, share messages |
| "Launch an affiliate program" | Launch checklist, commission structure recommendation, partner recruitment list template, affiliate kit outline |
| "What should our K-factor be?" | Virality model with your numbers — current K, target K, what needs to change to get there |
All output follows the structured communication standard:
© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 3 other files (scripts, references) in marketing-skill/skills/referral-program of alirezarezvani/claude-skills.
Open the folder on GitHubat commit 19392f7
Referral Program next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Referral Program this skillalirezarezvani/claude-skills | 28k | — | ~3.4k | Automated safety check: Pass | MIT | |
| Referral Programfreekmurze/dotfiles | 1k | 16 repos | ~1.8k | Automated safety check: Pass | None | |
| Churn Preventionrongxinzy/RongxinAI | 154 | 3 repos | ~2.6k | Automated safety check: Pass | MIT | |
| 100m Leadsgetagentseal/founder-playbook | 721 | — | ~2.3k | Automated safety check: Pass | MIT | |
| Churn Preventionfreekmurze/dotfiles | 1k | 12 repos | ~4.4k | Automated safety check: Pass | None | |
| ReferralsCesarjoquin/Marketing-Skills | 199 | 1 repos | ~1.9k | Automated safety check: Pass | MIT |
freekmurze/dotfiles
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.
rongxinzy/RongxinAI
Reduce voluntary and involuntary churn through cancel flow design, save offers, exit surveys, and dunning sequences.
getagentseal/founder-playbook
Builds lead generation systems using Alex Hormozi's Core Four framework (warm outreach, content, cold outreach, paid ads), lead magnets, and Rule of 100.
freekmurze/dotfiles
When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies.
Cesarjoquin/Marketing-Skills
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.
aaron-he-zhu/aaron-marketing-skills
A skill your agent uses when the user asks to "design a welcome flow", "set up an abandoned-cart sequence", "build a light re-engagement branch inside a lifecycle flow", or "plan a cold-outbound…
alirezarezvani/claude-skills
Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.
alirezarezvani/claude-skills
OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.
alirezarezvani/claude-skills
App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.
alirezarezvani/claude-skills
Design AWS architectures for startups using serverless patterns and IaC templates.
alirezarezvani/claude-skills
Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.
alirezarezvani/claude-skills
Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.
Categories
When the user wants to design, launch, or optimize a referral or affiliate program. Referral Program is an agent skill from alirezarezvani/claude-skills. When the user wants to design, launch, or optimize a referral or affiliate program.
Referral Program fits situations like: wants to design; optimize a referral; affiliate program; they mention referral program.
Run `npx skills add alirezarezvani/claude-skills --skill referral-program -a claude-code`. Or copy the skill folder (marketing-skill/skills/referral-program in alirezarezvani/claude-skills) into .claude/skills/referral-program in your project. Claude Code loads it when a task matches its description.
Run `npx skills add alirezarezvani/claude-skills --skill referral-program -a codex`. Or copy the skill folder (marketing-skill/skills/referral-program in alirezarezvani/claude-skills) into .agents/skills/referral-program in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill referral-program -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/referral-program, .gemini/skills/referral-program, .github/skills/referral-program and .opencode/skills/referral-program in your project.
Going by SKILL.md and its folder, Referral Program needs Python for the scripts in its folder. Our summary lists: Python 3.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Referral Program is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.4k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Referral Program: Referral Program (freekmurze/dotfiles, 1k stars), Churn Prevention (rongxinzy/RongxinAI, 154 stars), 100m Leads (getagentseal/founder-playbook, 721 stars) and Churn Prevention (freekmurze/dotfiles, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,788 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.
Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.