Skip to content
cccskills
FreePublished on GitHub

suede-referrals

Suede AI referral and affiliate program design: refer a friend and ambassador mechanics, incentive sizing from LTV and margin, affiliate commission structures, payout logic, fraud controls, attribution, FTC endorsement disclosure and incentivized-review rules, and viral loop measurement (K-factor, cohort LTV of referred customers). Returns a program spec with economics, rules, tooling options, and a launch checklist. Use when designing refer-a-friend mechanics, ambassador or partner incentives, affiliate programs, payout logic, or viral-loop measurement. NOT FOR: executing payouts or changing billing, co-marketing with a partner brand (use suede-co-marketing), launch-wide packaging (use suede-launch-packaging), lifecycle messaging (use suede-emails), or reporting unverified referral lift.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (6)

  • SKILL.md9.5 KB
  • agents/openai.yaml583 B
  • CARD.md4.5 KB
  • evals/evals.json6.3 KB
  • references/affiliate-programs.md4.3 KB
  • references/program-examples.md3.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Suede Referral & Affiliate Programs

Suede AI 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.

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

Prompt cadence for customers who have not referred: day 7, day 30, day 60, and after any milestone. The timing is this skill's call; the message copy is not: hand that to suede-emails.

Step 2: Design Share Mechanism

Ranked by effectiveness:

  1. In-product sharing (highest conversion)
  2. Personalized link
  3. Email invitation
  4. Social sharing
  5. 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 program patterns 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

ProblemFix
Low awarenessAdd prominent in-app prompts
Low share rateSimplify to one click
Low conversionOptimize referred user experience
Fraud/abuseApply the fraud controls below
One-time referrersAdd tiered/gamified rewards

Fraud Controls

Read references/affiliate-programs.md §Fraud Prevention before designing rewards or writing program terms: it carries the technical, policy, and structural control set (delayed payout after activation, device and IP signals, clawback on refunds, per-period caps, manual review of suspicious patterns). Every program in this skill uses it, customer referral programs included, not only affiliate programs.

Set these thresholds explicitly, because the reference leaves them open:

  • Name the qualifying downstream event that releases a reward (a paid conversion or day-N retention, N stated), never signup alone.
  • Hold payouts until the refund/chargeback window has closed, and state that window in days.
  • State the dollar amount above which a payout goes to manual review before it is released.

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

Peer-reviewed field research (for example "Referral Programs and Customer Value," Journal of Marketing, 2011, a study of bank customers) found referred customers more valuable and less likely to churn than other customers; vendor reports claim a wide range of larger effects with undisclosed methods. Treat any figure as a hypothesis: compare referred and non-referred cohorts on retention, LTV, and onward referral rate in this product's own data before claiming an effect.

Disclosure and incentive rules

  • Referrers and affiliates who are paid or rewarded must clearly disclose that connection where they recommend you (FTC Endorsement Guides, revised 2023: FTC guidance).
  • Do not reward reviews conditioned on positive sentiment, and do not suppress negative ones (FTC Consumer Reviews and Testimonials Rule, effective October 21, 2024).
  • Contests and milestone giveaways can fall under sweepstakes law; payouts can create tax reporting duties. Flag both for the user's counsel and finance owner.

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

Affiliate Programs

For affiliate program design, commission structures, recruitment, fraud prevention, and tools: See references/affiliate-programs.md


Tool Integrations

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.

ToolBest ForVerify Before Use
Rewardful / ToltSaaS affiliate programsBilling integration, attribution, payouts
Mention MeEnterprise referral programsIdentity, fraud, and reporting controls
Dub.coLink tracking and attributionAttribution window and privacy settings
StripeCommission-related payment recordsLive objects, fees, approvals, tax workflow
IntrowTiered channel partner operationsDeal registration and payout governance
PartnerStackEnterprise partner ecosystemsFees, attribution, approval, data export

Boundaries

  • Do not enable a program, create affiliate accounts, issue links, execute payouts, or change billing and commission objects without verified live state and explicit approval.
  • Do not invent attribution, conversion, fraud, or viral-coefficient results; distinguish modeled economics from observed data.
  • Do not decide tax, labor, privacy, contest, endorsement, or incentive compliance. Surface the jurisdiction-specific review needed before launch.

Routing

  • Use suede-launch-packaging to coordinate the approved program launch.
  • Use suede-emails for referral invitation and nurture sequences.
  • Use suede-offers (behavioral-models catalog) to frame incentive tests as evidence-tiered hypotheses.
  • Use suede-ab-testing to design and evaluate the incentive, messaging, and placement tests above.
  • Use suede-analytics to define and read referral attribution.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Suede AI Android app factory: plan, build, test, and prepare a production native Android app from product idea to a Play-ready signed bundle. Use for requests to create, ship, monetize, or modernize an Android app. Covers Kotlin and Jetpack Compose architecture, live target-API and Play policy checks, 16 KB page sizes, accessibility, privacy and Data Safety, Play Billing Library 8+, Play Integrity, account deletion, kids and Families rules, testing, performance, store assets, signing, and a release evidence gate. NOT FOR: uploading, promoting, or rolling out a build on Play (use suede-play-release); turning a website into an iOS app (use site-to-ios-app); a review-only pass on an existing app (use suede-code --findings-only); Play listing, keyword, and screenshot strategy (use suede-aso).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Design, review, and visually QA web and app interfaces against explicit design laws so shipped screens look intentional instead of generic AI output.

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Suede AI workflow for turning a live website, PWA, dashboard, or marketplace into an iOS app. Use when the user has a site or web app and asks to put it on the App Store, wrap it in an app, ship an iOS version, or convert a PWA to native. Produces SITE_TO_IOS_AUDIT.md and SITE_TO_IOS_PLAN.md: URL audit, shell-vs-native strategy, App Store Guideline 4.2 wrapper risk and the native value that mitigates it, current SDK, privacy manifest, age rating, login and payment checks, kids-app rules, QA matrix, and a release gate. NOT FOR: Android builds or conversions (use android-app-factory); Google Play uploads and rollouts (use suede-play-release); App Store listing, keyword, and screenshot strategy (use suede-aso).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Suede AI experimentation discipline: hypotheses, sample size and power, test duration, guardrail metrics, significance and readouts, sequential designs, and an ICE-ranked experiment backlog with a reusable playbook. Use when comparing variants, deciding whether a result is reliable, or building an experiment program and cadence. NOT FOR: analytics instrumentation (use suede-analytics), post-click conversion diagnosis (use suede-site-alchemy), writing the variant copy (use suede-copy), or channel-level incrementality and geo holdouts (use suede-attribution).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Suede AI paid-media creative system: angles, hooks, headlines, primary text, RSA and Performance Max assets, static and motion concepts, iOS-native reveal videos, grounded batch production, client review pages, and iteration from performance data, all checked against platform character limits. Use when producing or iterating ad creative for Google, Meta, LinkedIn, TikTok, or X from real product, review, and performance inputs. NOT FOR: campaign budgets, bidding, or targeting (use suede-ads), statistical test design (use suede-ab-testing), organic social posts (use suede-social), general marketing images such as OG or hero graphics (use suede-image), or landing-page copy (use suede-copy).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Suede AI paid-acquisition operating system for channel choice, campaign structure, audiences, bidding, budget pacing, negative keywords, retargeting, B2B and ABM playbooks, and kill-or-scale decisions, with platform facts checked in October 2026 (Meta Andromeda and attribution windows, Performance Max controls). Use when planning, auditing, or optimizing paid campaigns on Google, Meta, LinkedIn, X, TikTok, or comparable platforms. NOT FOR: producing ad copy or creative variants (use suede-ad-creative), implementing tracking (use suede-analytics), attribution models or reconciliation (use suede-attribution), or the landing page (use suede-site-alchemy).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

See all skills by JasonColapietro

Report a problem with this skill