agentsclimarketplace

Referrals

Skill agent-k-labs/shipping-skills/skills/referrals

AI agent skills for everything after the AI builds your app — launch, get users, grow. Works with Claude Code, Cursor, Windsurf.

Install
npx -y skills add agent-k-labs/shipping-skills --skill referrals

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Build a referral loop sized for a small product — pick the right incentive, write the ask, wire minimal tracking with ?ref= links, and know when a formal referral program is premature. Use when the user asks "should I add a referral program," "how do I get word of mouth," "give users an invite link," "refer a friend feature," or growth has stalled and they want users bringing users.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

4.7 KB, as published. Nobody here has run it

Referrals

Referral programs fail at small scale for one reason: they formalize word-of-mouth that doesn't exist yet. The order is: make the product worth mentioning → make mentioning effortless → then add incentives. This skill builds that ladder and stops you from shipping a rewards system nobody triggers.

Context

Read product-context.md if present. Otherwise ask for:

  1. Product, pricing, and current user counts (free / paid)
  2. Any organic word-of-mouth signal so far (users mentioning it publicly, "how did you hear about us" answers)
  3. What a user could give a friend (extended trial, credits, discount) and what it costs you
  4. Stack — where invite links and credit grants would live

Process

1. Readiness check (be honest)

A referral program amplifies existing word-of-mouth; it cannot create it. Prerequisites:

  • ≥ 1 organic referral you know of (someone mentioned it unprompted)
  • Retention holds — referring users into a leaky product burns the referrer's trust too
  • < both → skip to step 2 and stop there; revisit incentives at ~100 active users

2. The zero-infrastructure referral loop (do this first)

  • Make output shareable by default. Whatever the product produces should carry a tasteful attribution ("Made with [Product]") that links back — with the user's ?ref= code if they have one. This is the highest-converting referral surface most products already own.
  • The founder ask. After a user's clear win (activation, a success moment, praise in support), send one line: "Glad it worked — if you know one other founder with this problem, here's a link that gives them [perk]." Timing beats incentive: ask at the peak, not in a drip.
  • Track with ?ref= codes — a per-user code appended to the product URL, captured into a source column on signup. One column, no SaaS.

3. Choose the incentive (when step 1 passes)

IncentiveUse whenWatch out
Two-sided credit (both get a month/credits)Paid SaaS with usage-based valueCost caps: limit rewards per referrer/month
Extended trial for the friend onlyConversion bottleneck is trial lengthWeak referrer motivation — pair with recognition
Founding-member status / early accessPre-launch or waitlist stageOnly works while access is genuinely scarce
Cash / affiliate %High LTV, B2B, promoters are creatorsAttracts mercenaries; needs payout plumbing — last resort

Default for a solo SaaS: two-sided credit in your product's native unit (e.g. "you both get 20 credits"). It rewards in product value, costs marginal COGS, and reinforces usage.

4. Wire the minimum program

  1. Per-user referral code on the account page: yourapp.com?ref=<code> + a pre-written share message they can copy
  2. Signup captures refsource; a credit grant to both sides on the referred user's activation (not signup — reward real users, not email addresses), idempotent by (referrer, referred) pair
  3. Show the referrer their tally ("2 friends joined — 40 credits earned")
  4. Announce once to existing users (email + changelog), then let the product surfaces carry it

5. Measure whether it's real

Monthly: referred signups, referred-user activation rate vs. baseline, cost of granted credits. Healthy loop: referred users activate better than average. If referred signups < 5% of total after 60 days, the loop isn't the constraint — go back to retention or acquisition.

Output

  1. Readiness verdict — amplify or wait, based on this product's actual signals
  2. Shareable-output spec — where "Made with" attribution + ref link goes in this product
  3. The ask — founder message with the trigger moment defined for this product
  4. Incentive recommendation — one incentive with cost math at current usage
  5. Implementation spec — schema (ref code, source capture, idempotent grants), account-page UI copy, and the announcement email
  6. 60-day scorecard — the three numbers that decide keep/kill

The share message needs something worth sharing. SoloMax gives every user a launch video made from their product URL — the kind of output people post publicly, attribution and all.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.