MCPInstall

referral-incentive-design

Design the reward structure of a customer refer-a-friend program - who gets rewarded (referrer, friend, or both), reward type (cash, account credit, discount, product value, status), how much to pay against LTV/CAC and gross margin, when the payout fires, and whether to build a tiered reward ladder. Use whenever the user mentions referral incentives, refer-a-friend rewards, referral bonus amounts, give-X-get-Y offers, double-sided referral rewards, or asks how big a referral reward should be, even if they never say incentive. Covers end-customer rewards only. Do NOT use for commission rates paid to professional affiliates - use mbfinotti/partnerships-skills@affiliate-commission-structure instead.

Installs
13.5K
Last 24h
+487
Trending rank
#711
Security
Pass

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/mbfinotti/partnerships-skills --skill referral-incentive-design
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads referral-incentive-design automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·The skill consists of markdown-based design guidelines for referral incentives without any executable code or network operations.
Socket PassNo alerts
Snyk PassLOW ·Risk: LOW · No issues

SKILL.md

The instructions your agent reads when the skill is triggered.

Referral Incentive Design

Design the reward structure of a customer refer-a-friend program. No canonical named framework exists for this discipline - referral is one letter inside measurement funnels like AARRR, not a design method. What exists is four decision variables, each with its own evidence base, worked through in order because each shapes the next:

  1. Sidedness - reward the referrer, the friend, or both (the Reward-Me / Reward-You / Reward-Both taxonomy, Ryu & Feick, Journal of Marketing 2007).
  2. Reward type - cash, account credit, discount, product value, status, or donation.
  3. Reward size - anchored to gross margin, LTV, and CAC, with a floor set by non-monotonic response (a too-small reward performs worse than none).
  4. Payout trigger and tier structure - when the reward fires, and whether rewards escalate with cumulative referrals.

Interview

Ask before recommending anything. One question per message; offer multiple-choice answers when possible. Skip a question only when the user already gave the answer.

  • Is the business B2B or B2C? Subscription or one-time purchase? Self-serve or sales-led?
  • What are the gross margin, average LTV (or first-year revenue), blended/paid CAC, and entry-plan price?
  • Do customers already recommend the product organically? Roughly what share of new customers arrive that way?
  • Will the referrer plausibly buy again (account credit has value to them), or not (only cash-equivalents do)?
  • For B2B: is the likely referrer the buyer, or an employee whose company pays?
  • By what date must this show results? A hard quarter-end date promotes the fast rungs - a flat reward on a first-purchase trigger - and rules out ladders and retention-gated triggers, which need months to read.
  • One-off acquisition win, or a compounding asset? Compounding promotes in-kind and status rewards, a tier ladder, and a retention-gated trigger; a one-off win promotes a flat friend-side offer.
  • What is the effort ceiling: who builds and administers this, how many hours do they have, and can a published reward be withdrawn later? A low ceiling deletes swag, sweepstakes, and staged payouts outright; a dedicated owner puts the ladder back on the table.

Workflow

  1. Run the Interview above; collect every answer the structure depends on before designing.

  2. Check the disqualifiers before designing. A referral program captures existing word-of-mouth; it does not create it. No organic referral signal, or an LTV too low to fund a meaningful reward, means the honest answer is "not yet" - say so and stop. Confirm the question is about end-customer referrals, not external affiliates or channel partners (different economics, different tooling; B2B programs tend to migrate from the former to the latter as ACV grows).

  3. Decide sidedness, working from references/sidedness-and-triggers.md. Efficiency order: friend-only > double-sided > referrer-only - effort is identical across the three arms, so the value evidence decides, and field experiments found recipient-only rewards matching double-sided rewards that cost twice as much. Lead with friend-only; move to double-sided for an innovative product or a weak brand with weak ties, and to referrer-only only for a genuinely high-effort referral process.

  4. Choose the reward type per side from references/reward-types.md, leading with its efficiency order: in-kind product value > account credit == free months > discount > status > cash > swag > charity > sweepstakes. Then apply the criteria that override it:

    • Cash-equivalents when the referrer will never rebuy or the product is money-adjacent.
    • Status over cash when referring is a public, identity-driven act.
    • Charity only ever as a choice.

    For B2B, resolve the principal-agent fork (individual reward vs company account credit) explicitly.

  5. Size the reward using references/sizing-and-tiers.md: compute the gross-profit ceiling, pick a target inside it starting from the least-effort anchor (% of CAC > % of LTV > payback discipline), verify the floor (non-monotonic response: pay meaningfully or pay nothing), and frame the number with the Rule of 100 (percentage below $100, absolute amount above).

  6. Set the payout trigger on a verified value event, never bare signup. Efficiency order: first purchase > qualified activation > closed-won/first invoice > retention threshold > staged payout; promote closed-won for a sales-led B2B motion, and the retention threshold when refund or churn exposure is large. Match the holding period to refund risk and sales-cycle length.

  7. Decide whether to tier, against the ladder rules in references/sizing-and-tiers.md. Efficiency order: flat > threshold ladder > stepwise; the ladder is worth its build cost only when volume is high, repeat referrers are plausible, and advocacy concentrates in a few advocates. First tier trivially achievable; top tier always capped - the best-documented failure in this field is an uncapped ladder.

  8. Present the four decisions one by one - options considered, trade-offs, and your recommendation - and validate each with the user; revise on pushback before moving to the next.

  9. After explicit approval on all four, emit the full structure as a testable spec (next section), grounded in a matching worked example from references/examples.md when one fits the user's situation.

  10. If your harness has persistent memory, memorize the approved spec's key decisions and economics - a later diagnosis run starts from them instead of re-interviewing.

Every ordering above ranks value returned per unit of effort - build time, administration, fulfillment, coordination, and how hard the choice is to reverse once published. Never rank by payout size; what a reward costs is a separate axis, and the two disagree often enough that a blended rank hides the case where the cheapest option and the strongest one are different options.

Each order is a default, not a law: it shifts with the situation and with who has to execute it. Re-rank against what you already know about this user before presenting any menu:

  • A product whose marginal unit costs near zero promotes in-kind rewards above everything.
  • A finance team that refuses cash payouts deletes cash from the menu rather than demoting it.
  • An existing rewards platform erases the effort gap that puts ladders and swag near the bottom.

Say out loud which fact moved which option, so the user can argue with the reasoning instead of the row order.

The Reward Structure Spec

Deliver every engagement as this artifact - a decision record the user can hand to product, finance, and a test-plan owner:

REWARD STRUCTURE - <product>, <date>
Sidedness        : both | friend-only | referrer-only, split, disclosure choice
Reward (friend)  : type, amount, framing ("first month free", not "$49 off")
Reward (referrer): type, amount, framing
Payout trigger   : verified event per side + holding period + pending-state display
Tiers            : ladder breakpoints + top-tier cap, or "flat - revisit when <condition>"
Caps             : per-referrer/year, total-earned, program budget ceiling
Economics        : gross-profit ceiling, projected cost per referred customer vs current CAC
Validation       : test arms, % of base exposed, duration, decision metric, incrementality check
KPIs             : participation rate, share-to-signup conversion, cost per incremental referred customer vs CAC

Three rules about the spec itself:

  • Every line carries a reason. "Referrer credit fires on the second invoice - survives the refund window" is reviewable; a bare amount is not.
  • The validation plan is not optional. Sidedness is genuinely contested between practitioners and field research, so name its test arms (both / friend-only / referrer-only, on 5-10% of the base) and its incrementality check. The incrementality check means holding out a slice: flat acquisition volume with rising CAC shows the program pays for customers who would have come anyway.
  • The spec has a pass threshold. Projected cost per incremental referred customer must land below current blended CAC and inside the gross-profit ceiling. Iterate size, type, or trigger until both hold; if no structure passes, recommend not launching.

Diagnosing an Existing Program

When the user arrives with a running program instead of a blank page ("we give $10 credit and nobody uses it"), work the fixes in efficiency order - most program repaired per unit of effort, which is not the same as the cheapest fix first:

efficiency: reposition the ask > reweight the split toward the friend > raise the size above the floor > cap the ladder and move the trigger > switch reward type > run the incrementality holdout

SymptomCheck firstEffortVariable at fault
Few customers ever shareTiming and friction of the ask - placement moves participation more than reward size doesAn hour - move the prompt, change the copyNone - fix the ask before touching the reward
Shares happen, friends do not convertFriend-side offer strength - the friend has the harder jobAn hour - reweight a budget you are already spendingSidedness/split
Participation dropped after adding a rewardToken amount below the motivation floor turned a favor into a badly paid jobAn hour of config, against a permanent budget increaseSize
Power referrers milk the ladderMissing top-tier cap or signup-fired triggerA day or two - and capping a published ladder is the hardest change here to make stickTiers/trigger
B2B referrers decline rewardsCorporate gift policy collisionA quarter - finance, procurement and legal all touch itType: switch to the two-track pattern (company credit + optional individual token)
Healthy referral volume, rising CACIncrementality - rewards paying for organic word-of-mouthA quarter - design the holdout, wait out a full cycle to read itEconomics: run the holdout, then narrow the reward to low-organic-reach segments

The order starves the incrementality holdout: it lands last on ratio and first on truth, because it is the only check that can reveal the whole program is buying customers who were coming anyway. Promote it immediately when referral volume looks healthy while CAC climbs - that is the one symptom no cheap fix explains. Re-rank the rest against the user's constraints too: a team that cannot ship UI this quarter cannot reposition the ask, which pushes the split reweight to the top.

B2B and B2C

Identical in both, whether B2B or B2C:

  • The four decisions and their order.
  • The gross-profit ceiling.
  • The non-monotonic floor.
  • The Rule of 100 framing.
  • The payout trigger on a verified value event.
  • The incrementality haircut.

Do not reinvent any of them per side.

The evidence base is the asymmetry worth stating out loud: the field experiments and academic results this skill leans on are overwhelmingly consumer-side. Treat every number here as B2C-measured and B2B-inferred, and say so when advising a B2B program.

DimensionB2CB2B
Who is rewardedThe customer, who is also the payerOften an employee who is not the payer - resolve the principal-agent fork explicitly at step 4
Reward vehicleAccount credit or cash-equivalent to the individualCompany account credit by default; an individual reward is a gift-policy and procurement question before it is an incentive
Payout triggerFirst paid invoice or an activation milestoneLater - closed-won or a retention threshold, because the cycle is longer and refund exposure larger
Scaling ceilingHolds at scaleReal: as ACV grows, customer-referral programs migrate into affiliate or partner programs. Watch for the migration signal rather than stretching this structure past it
Disclosure sensitivityModerateHigher - a referrer recommending a vendor to their own network carries a material connection their employer may also police

Invocation Examples

  • "Design the refer-a-friend rewards for a $49/mo B2B SaaS - 80% margin, 14-month average tenure, $220 paid CAC."
  • "We give $10 credit both sides and nobody uses it. Diagnose which of the four variables is at fault."
  • "Should our referral rewards be tiered? About 8% of customers refer, and a handful refer repeatedly."

Reference

  • mbfinotti/partnerships-skills@affiliate-commission-structure for commission design aimed at professional affiliates and partners.
  • mbfinotti/partnerships-skills@referral-abuse-guardrails for the enforcement layer around caps - velocity limits, cooldowns, burst detection, verification gates, and the published wording that makes a cap stick. This skill sets the cap values; that skill makes them hold.

FAQ

What does the referral-incentive-design skill do?

Design the reward structure of a customer refer-a-friend program - who gets rewarded (referrer, friend, or both), reward type (cash, account credit, discount, product value, status), how much to pay against LTV/CAC and gross margin, when the payout fires, and whether to build a tiered reward ladder. Use whenever the user mentions referral incentives, refer-a-friend rewards, referral bonus amounts, give-X-get-Y offers, double-sided referral rewards, or asks how big a referral reward should be, even if they never say incentive. Covers end-customer rewards only. Do NOT use for commission rates paid to professional affiliates - use mbfinotti/partnerships-skills@affiliate-commission-structure instead.

How do I install referral-incentive-design?

Run npx skills add https://github.com/mbfinotti/partnerships-skills --skill referral-incentive-design in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/referral-incentive-design/ (personal) or .claude/skills/referral-incentive-design/ (project).

Which AI agents can use referral-incentive-design?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is referral-incentive-design safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains referral-incentive-design?

It is published by mbfinotti in mbfinotti/partnerships-skills. It has 13,540 recorded installs.

More from mbfinotti/partnerships-skills

View all →

affiliate-payout-audit

mbfinotti/partnerships-skills

Audit an affiliate or partner commission payout run for accuracy before money is disbursed - per-line rate and tier recomputation, double-counted conversions, clawback and validation windows, period cutoff, currency, rounding, and tax-form status, delivered as an audit report with severities and recommended holds. Covers B2B SaaS recurring revenue-share and B2C ecommerce order-level CPA programs. Use whenever the user mentions an affiliate payout audit, commission accuracy, payout reconciliation, overpaid or underpaid affiliates, or a pre-disbursement review, even if they never say audit. Do NOT use for spotting fraudulent affiliates - use mbfinotti/partnerships-skills@affiliate-fraud-detection instead.

Security14K installs

affiliate-disclosure-compliance

mbfinotti/partnerships-skills

Check a specific piece of affiliate or influencer content (caption, video script, transcript, screenshot, or live URL) against disclosure regulations and return a pass/fail compliance review with placement, wording, and per-format fixes. Covers FTC affiliate disclosure (16 CFR 255 and 465), UK CAP/CMA rules, EU UCPD and DSA, and German, French and Italian overlays, pre-publication or already live. Use whenever the user mentions affiliate disclosure, FTC disclosure, paid partnership labeling, sponsored content, ad tags, or a partner post that may be missing or burying its disclosure, even if they never say compliance. Reviews content only - for disclosure clauses inside program terms use mbfinotti/partnerships-skills@affiliate-program-terms.

Security14K installs

affiliate-performance-dashboard

mbfinotti/partnerships-skills

Define the metric set and layout for an affiliate performance dashboard, delivered as a dashboard specification document - metric definitions with explicit formulas, views per audience, refresh and review cadence, and alert thresholds for top affiliates, conversion by source, and program ROI. Covers B2B SaaS recurring revenue-share and B2C ecommerce order-level CPA programs. Use whenever the user mentions affiliate program reporting, affiliate KPIs, affiliate ROI, revenue concentration, or what to put on an affiliate dashboard, even if they never say dashboard. Specifies metrics, never builds them in a BI tool. Do NOT use for one creator campaign's measurement plan - use mbfinotti/partnerships-skills@influencer-measurement-framework instead.

Data & Databases13.9K installs

affiliate-fraud-detection

mbfinotti/partnerships-skills

Build the detection rule set an affiliate program manager uses to flag fraudulent affiliate activity, plus the investigation and escalation path behind it - cookie stuffing, fake lead and form-fill fraud, self-referral rings, traffic-quality baselines, commission holds and clawbacks, and separating real fraud from legitimate low-incrementality coupon or cashback partners. Covers B2B SaaS lead-gen and B2C ecommerce programs. Use whenever the user mentions affiliate fraud, suspicious affiliate traffic, invalid clicks or leads, bot traffic, or an affiliate whose numbers look too good, even if they never say fraud. Do NOT use for consumer refer-a-friend gaming - use mbfinotti/partnerships-skills@referral-abuse-guardrails instead.

Business & Finance13.9K installs

alliance-prioritization

mbfinotti/partnerships-skills

Rank named candidate strategic alliances and technology partnerships by expected value, effort, and risk, to decide where partner-team capacity goes - must-pass screens, a weighted alliance scorecard with sensitivity analysis, co-innovation and platform-dependency risk checks, a ranked shortlist, and a go/no-go recommendation memo. Covers B2B tech alliances and B2C brand and creator partnerships. Use whenever the user mentions alliance prioritization, partnership ranking, partner shortlisting, or asks which of several named partners deserves investment, even if they never say prioritization. Portfolio-level comparison only. Do NOT use for modeling one partner's P&L - use mbfinotti/partnerships-skills@partner-economics instead.

Marketing & SEO13.9K installs

affiliate-recruitment-outreach

mbfinotti/partnerships-skills

Draft the outreach copy and sequence plan used to recruit new affiliates into a commission-based affiliate program - prospect qualification and tiering, pitch angle, first-touch recruitment email, follow-up sequence with a breakup touch, channel mix, and outreach tracking. Covers B2B SaaS and B2C ecommerce/DTC programs. Use whenever the user mentions recruiting affiliates, affiliate sourcing, or pitching content and review sites, coupon and cashback partners, newsletter operators, communities, podcasters, or agencies to join a program, even if they never say recruitment. Do NOT use for pitching one individually vetted creator - use mbfinotti/partnerships-skills@influencer-outreach instead.

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs