JasonColapietro/suede-creator-skills / skills/suede-referrals
suede-referrals
VerifiedDesign a referral and affiliate program with incentives, commission and payout rules, fraud controls, disclosure, attribution, and cohort measurement. Use when asked to "design our referral program" or repair customer, ambassador, or partner incentives. Returns a program spec, economics, tooling options, and launch checklist. NOT FOR: payouts or billing changes, brand partnerships (use suede-co-marketing), launch packaging (use suede-launch-packaging), or lifecycle messages (use suede-emails).
| File | Kind | Size |
|---|---|---|
| CARD.md | markdown | 4.3 KB |
| SKILL.md | skill md | 9.5 KB |
| agents/openai.yaml | config | 589 B |
| evals/evals.json | config | 6.3 KB |
| references/affiliate-programs.md | markdown | 4.3 KB |
| references/program-examples.md | markdown | 3.9 KB |
| references/worked-handoff.md | markdown | 1.6 KB |
references/program-examples.md
View on GitHub# Referral Program Patterns
Four program shapes that recur across consumer and SaaS referral programs, described as patterns rather than company case studies (public programs change terms often, and their results are rarely published with methods). Pick the shape that matches how the product creates value, then test it.
## Contents
- Product-for-product (two-sided)
- Credit-for-credit at a natural moment
- Milestone tiers (newsletters and communities)
- Segment-targeted credit
- Incentive Types Comparison
- Incentive Sizing Framework
- Viral Coefficient & Metrics (Key Metrics, Calculating Referral Program ROI)
## Product-for-product (two-sided)
**Shape:** both people get more of the product itself, such as extra storage, seats, or usage.
**Why it can work:**
- The reward is the product's own value, so it attracts users who want the product
- Low friction (an email or link)
- Both parties benefit equally
- Progress toward a cap can be shown in-product
---
## Credit-for-credit at a natural moment
**Shape:** a fixed credit for the new user and the referrer, released when the new user completes a first purchase or first use.
**Why it can work:**
- Immediate, clear value on both sides
- Easy to share as a code or link
- Prompted at moments of satisfaction (after a good delivery, ride, or result)
---
## Milestone tiers (newsletters and communities)
**Shape:** escalating rewards at referral counts (for example 3, 5, 10, 25), often physical goods or access.
**Why it can work:**
- Repeat motivation instead of a single action
- Physical rewards get photographed and shared
- Builds status inside the community
- Watch sweepstakes, shipping, and fraud costs as tiers rise
---
## Segment-targeted credit
**Shape:** a credit aimed at a group that shares heavily, such as students, team leads, or agency partners.
**Why it can work:**
- Concentrates spend on people with the widest networks
- Fits products that already spread inside teams
---
## Incentive Types Comparison
| Type | Pros | Cons | Best For |
|------|------|------|----------|
| Cash/credit | Universally valued | Feels transactional | Marketplaces, fintech |
| Product credit | Drives usage | Only valuable if they'll use it | SaaS, subscriptions |
| Free months | Clear value | May attract freebie-seekers | Subscription products |
| Feature unlock | Low cost to you | Only works for gated features | Freemium products |
| Swag/gifts | Memorable, shareable | Logistics complexity | Brand-focused companies |
| Charity donation | Feel-good | Lower personal motivation | Mission-driven brands |
---
## Incentive Sizing Framework
**Calculate your maximum incentive:**
```
Max Referral Reward = (Customer LTV × Gross Margin) - Target CAC
```
**Example:**
- LTV: $1,200
- Gross margin: 70%
- Target CAC: $200
- Max reward: ($1,200 × 0.70) - $200 = $640
**Starting points to test (not benchmarks):**
- B2C: $10-50 or 10-25% of first purchase
- B2B SaaS: $50-500 or 1-3 months free
- Enterprise: Higher, often custom
---
## Viral Coefficient & Metrics
### Key Metrics
**Viral coefficient (K-factor):**
```
K = Invitations × Conversion Rate
K > 1 = Viral growth (each user brings more than 1 new user)
K < 1 = Amplified growth (referrals supplement other acquisition)
```
**Example:**
- Average customer sends 3 invitations
- 15% of invitations convert
- K = 3 × 0.15 = 0.45
**Referral rate** (set targets from your own baseline; published benchmarks vary too widely to borrow):
```
Referral Rate = (Customers who refer) / (Total customers)
```
**Referrals per referrer**: track the distribution; a few heavy referrers usually drive most volume.
### Calculating Referral Program ROI
```
Referral Program ROI = (Revenue from referred customers - Program costs) / Program costs
Program costs = Rewards paid + Tool costs + Management time
```
**Track separately:**
- Cost per referred customer (CAC via referral)
- LTV of referred customers vs. other customers (compare cohorts)
- Payback period for referral rewards
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |