coreyhaines31/referrals
skills/referrals/SKILL.md
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' 'partner program,' 'referral incentive,' 'how to get referrals,' 'customers referring customers,' or 'affiliate payout.' Use this whenever someone wants existing users or partners to bring in new customers. For launch-specific virality, see launch.
$ install --global
skillsauthnpx skillsauth add coreyhaines31/marketingskills referralsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 19, 2026, 5:28 AM153.8s4 files scanned
SKILL.md
- name:
- referrals
- description:
- When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' 'partner program,' 'referral incentive,' 'how to get referrals,' 'customers referring customers,' or 'affiliate payout.' Use this whenever someone wants existing users or partners to bring in new customers. For launch-specific virality, see launch.
- version:
- 2.0.0
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?
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
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:
- In-product sharing (highest conversion)
- Personalized link
- Email invitation
- Social sharing
- 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
For examples and incentive sizing: See references/program-examples.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 have 16-25% higher LTV
- Referred customers have 18-37% lower churn
- Referred customers refer others at 2-3x rate
Launch Checklist
Before Launch
- [ ] Define program goals and success metrics
- [ ] Design incentive structure
- [ ] Build or configure referral tool
- [ ] Create referral landing page
- [ ] Set up tracking and attribution
- [ ] Define fraud prevention rules
- [ ] Create terms and conditions
- [ ] Test complete referral flow
Launch
- [ ] Announce to existing customers
- [ ] Add in-app referral prompts
- [ ] Update website with program details
- [ ] Brief support team
Post-Launch (First 30 Days)
- [ ] Review conversion funnel
- [ ] Identify top referrers
- [ ] Gather feedback
- [ ] Fix friction points
- [ ] Send reminder emails to non-referrers
Email Sequences
Referral Program Launch
Subject: You can now earn [reward] for sharing [Product]
We just launched our referral program!
Share [Product] with friends and earn [reward] for each signup.
They get [their reward] too.
[Unique referral link]
1. Share your link
2. Friend signs up
3. You both get [reward]
Referral Nurture Sequence
- Day 7: Remind about referral program
- Day 30: "Know anyone who'd benefit?"
- Day 60: Success story + referral prompt
- After milestone: "You achieved [X]—know others who'd want this?"
Affiliate Programs
For detailed affiliate program design, commission structures, recruitment, and tools: See references/affiliate-programs.md
Task-Specific Questions
- What type of program (referral, affiliate, or both)?
- What's your customer LTV and current CAC?
- Existing program or starting from scratch?
- What tools/platforms are you considering?
- What's your budget for rewards/commissions?
- Is your product naturally shareable?
Tool Integrations
For implementation, see the tools registry. Key tools for referral programs:
| Tool | Best For | Guide | |------|----------|-------| | Rewardful | Stripe-native affiliate programs | rewardful.md | | Tolt | SaaS affiliate programs | tolt.md | | Mention Me | Enterprise referral programs | mention-me.md | | Dub.co | Link tracking and attribution | dub-co.md | | Stripe | Payment processing (for commission tracking) | stripe.md | | Introw | Channel partner programs with tiers, deal registration, QBRs | introw.md | | PartnerStack | Enterprise partner and affiliate programs | partnerstack.md |
Related Skills
- launch: For launching referral program effectively
- emails: For referral nurture campaigns
- marketing-psychology: For understanding referral motivation
- analytics: For tracking referral attribution
Related Skills
coreyhaines31/public-relations
testing
VerifiedTrustedCommunity
When the user wants help with public relations, earned media, press coverage, journalist outreach, or media strategy (not pull requests). Also use when the user mentions 'PR,' 'public relations,' 'press,' 'press release,' 'press coverage,' 'media outreach,' 'pitch a journalist,' 'get featured,' 'media list,' 'media kit,' 'press kit,' 'newsjacking,' 'news hijack,' 'HARO,' 'Qwoted,' 'Featured,' 'Help A Reporter,' 'reporter request,' 'tech press,' 'TechCrunch,' 'earned media,' 'thought leadership placement,' 'op-ed,' 'guest article,' 'press contacts,' or 'how do I get press.' Use this for earned media work — finding journalists, pitching stories, newsjacking, and responding to press requests. For startup/SaaS/AI directory submissions, see directory-submissions. For product launches, see launch. For social-media engagement, see social. For cold-email outreach to prospects, see cold-email.
32,823SKILL.mdUpdated Jun 11, 2026
coreyhaines31/social
testing
VerifiedTrustedCommunity
When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' or 'find people asking for.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.
32,823SKILL.mdUpdated May 19, 2026
coreyhaines31/marketing-plan
tools
VerifiedTrustedCommunity
When the user needs a comprehensive marketing plan for a client, a company they advise, or their own product. Also use when the user mentions "marketing plan," "growth plan," "GTM plan," "go-to-market plan," "AARRR plan," "90-day marketing plan," "12-month marketing roadmap," "fractional CMO plan," or "fCMO plan." Generates an exhaustive 13-section plan structured by AARRR (Acquisition, Activation, Retention, Referral, Revenue), customized to the client's current budget, team, and stage, mapped to future funding milestones, cross-referenced with the 139-idea marketing-ideas library and an embedded 17-section current-state audit rubric, with a full marketing operations stack showing which skills and MCP/API integrations execute each part. Outputs a Notion-paste-ready markdown document. For positioning and ICP context before planning, see product-marketing. For stage-specific deep work, see onboarding, signup, emails, referrals, pricing.
31,096SKILL.mdUpdated May 30, 2026
coreyhaines31/customer-research
development
VerifiedTrustedCommunity
When the user wants to conduct, analyze, or synthesize customer research. Use when the user mentions "customer research," "ICP research," "talk to customers," "analyze transcripts," "customer interviews," "survey analysis," "support ticket analysis," "voice of customer," "VOC," "build personas," "customer personas," "jobs to be done," "JTBD," "what do customers say," "what are customers struggling with," "Reddit mining," "G2 reviews," "review mining," "digital watering holes," "community research," "forum research," "competitor reviews," "customer sentiment," or "find out why customers churn/convert/buy." Use for both analyzing existing research assets AND gathering new research from online sources. For writing copy informed by research, see copywriting. For acting on research to improve pages, see cro.
31,096SKILL.mdUpdated Mar 29, 2026