jasoncolapietro/suede-referrals
Suede-owned referral and affiliate program discipline. Use when designing refer-a-friend mechanics, ambassador or partner incentives, fraud controls, attribution, payout logic, or viral-loop measurement. NOT FOR: executing payouts or changing billing, launch-wide packaging (use suede-launch-packaging), lifecycle messaging (use suede-emails), or reporting unverified referral lift.
npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill suede-referrals
Suede Referrals designs measurable customer, affiliate, and partner loops from
incentive economics through attribution and fraud controls. It separates
modeled loop performance from observed results and keeps activation and payouts
behind approval.
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):
Best for:
Characteristics:
Best for:
Characteristics:
Trigger Moment → Share Action → Convert Referred → Reward → (Loop)
High-intent moments:
Ranked by effectiveness:
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
If few customers are referring:
If referrals aren't converting:
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
| 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 |
Program health:
Business impact:
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]
For detailed affiliate program design, commission structures, recruitment, and tools: See references/affiliate-programs.md
These are evaluation examples, not guaranteed integrations. Verify current
vendor documentation, pricing, account access, attribution behavior, payout
controls, tax support, and data-export terms before recommending a platform.
| Tool | Best For | Verify Before Use |
|------|----------|-------------------|
| Rewardful / Tolt | SaaS affiliate programs | Billing integration, attribution, payouts |
| Mention Me | Enterprise referral programs | Identity, fraud, and reporting controls |
| Dub.co | Link tracking and attribution | Attribution window and privacy settings |
| Stripe | Commission-related payment records | Live objects, fees, approvals, tax workflow |
| Introw | Tiered channel partner operations | Deal registration and payout governance |
| PartnerStack | Enterprise partner ecosystems | Fees, attribution, approval, data export |
payouts, or change billing and commission objects without verified live state
and explicit approval.
distinguish modeled economics from observed data.
compliance. Surface the jurisdiction-specific review needed before launch.
suede-launch-packaging to coordinate the approved program launch.suede-emails for referral invitation and nurture sequences.suede-marketing-psychology to test incentive framing.suede-analytics to define and read referral attribution.Take jasoncolapietro/suede-referrals from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.