Skip to content
Skills Library
Marketing & content · Automation

referral-program

/referral-program

This skill should be used when the user asks about a project's Referral Program, affiliates, referral codes or links, free membership days or cash commissions for members who bring friends, approving or suspending an affiliate, the reward ledger, or recording a payout to an affiliate.

Licence
MIT
Last repository change
09.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 09.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

This skill should be used when the user asks about a project's Referral Program, affiliates, referral codes or links, free membership days or cash commissions for members who bring friends, approving or suspending an affiliate, the reward ledger, or recording a payout to an affiliate.

Original author description

This skill should be used when the user asks about a project's Referral Program, affiliates, referral codes or links, free membership days or cash commissions for members who bring friends, approving or suspending an affiliate, the reward ledger, or recording a payout to an affiliate.

How it works

  1. The programme
  2. How a referral is counted
  3. Affiliates and the ledger
  4. Do not
  5. References
Original SKILL.md headings · 38 lines, 654 words
SKILL.md preview
---
name: referral-program
description: "This skill should be used when the user asks about a project's Referral Program, affiliates, referral codes or links, free membership days or cash commissions for members who bring friends, approving or suspending an affiliate, the reward ledger, or recording a payout to an affiliate."
license: MIT
metadata:
  category: creators
  catalogue: 2026-05-01
---

# The Referral Program

A project's one programme turns members into affiliates: each who joins gets a code and a link, a friend who arrives through them is theirs for thirty days, and when the friend's first payment settles the affiliate earns what the creator promised. Subscriby tracks every touch, quotes every reward when the payment lands, holds cash commissions through the refund window, reverses them on a refund, and keeps the ledger the creator pays from. Bundled with the Growth Plan; on Free and Starter through the Referral Program Addon. It is not the Partner Program, where a creator refers creators to Subscriby and Subscriby pays (`account-and-billing`).

## The programme

`get_referral_program` reads it; `update_referral_program` creates it on the first call and later changes only the arguments present:

- `reward_kind`: free membership days (`reward_days`, banked on the affiliate's own membership, waiting on their balance if they hold none) or a cash commission (`commission_type` percentage or fixed, `commission_value`, `commission_currency_id`; a percentage can run for the first payment only, a number of `commission_period_months`, or for life; a fixed amount earns on the first payment only).
- `friend_reward_kind`: nothing, free days (`friend_reward_days`) or one of the project's coupons applied at the friend's checkout (`friend_coupon_id`; needs coupon codes on the plan).
- `hold_days` (default 14) before a commission is payable; `customers_only` (only members with a live membership may join); `approval_required`; `minimum_payout` (a guide for the creator, shown to nobody); `terms` and `payout_details_label` (the question affiliates answer so they can be paid, such as a PayPal email); `plan_ids` (conversions outside the list earn nothing); `active`.

`activate_referral_program` and `deactivate_referral_program` switch it (a pause stops links counting and payments earning at once, keeps the ledger readable, tells every affiliate; switching back on tells them the terms as they stand); `delete_referral_program` is refused while any affiliate is owed a commission. Rewards never change after they are written; a change applies to payments that settle afterwards.

## How a referral is counted

A friend arrives through the affiliate's portal link, their bot link, or by typing the code where the checkout asks for a coupon; they are counted for thirty days, the first affiliate to touch them keeps them, an existing payer cannot be referred, and an affiliate cannot refer themselves. The reward is earned when the first payment settles: days are banked at once; a commission is written `pending`, becomes `payable` when the hold passes, is `reversed` by a refund inside the hold, and a refund after a payout writes a clawback the next payout nets.

## Affiliates and the ledger

- `list_referral_affiliates` (`status`, `member_id`), `get_referral_affiliate` (the one read with the per-currency balances: earned, payable, paid), `add_referral_affiliate` by `member_id` (approved whatever the switches say), `approve_referral_affiliate`, `suspend_referral_affiliate` (their code stops counting; what they earned stays payable).
- `list_referrals` (`status`, `affiliate_id`, `since`), `get_referral`, `list_referral_rewards` (`affiliate_id`, `status`, `beneficiary`) for the friends and the ledger.
- `list_referral_payouts` and `record_referral_payout` (`affiliate_id`, `amount`, `currency_id`, `reference`, `note`): a payout **records money that already left** the creator's hands, marks the oldest payable commissions in that currency as paid up to the amount, and tells the affiliate; it is refused above the payable balance, so read `get_referral_affiliate` first. An affiliate's own payout details (the wallet or email they typed) never travel over the tools or the webhooks; the creator reads them on the dashboard.

## Do not

- Do not record a payout the creator has not made, and never above the balance read first.
- Do not promise a reward on a renewal unless the programme's commission runs over a period or for life.
- Do not confuse it with the Partner Program or with coupons.

## References

- [references/tools.md](references/tools.md): the fifteen tools with their arguments.
- [references/events.md](references/events.md): the ten `referral.*` events (programme updated, affiliate joined, approved, suspended, captured, converted, reward earned, approved, reversed, payout recorded).
- [references/endpoints.md](references/endpoints.md): the REST twins under `/v1/projects/{project}/referral-program`, `/referral-affiliates`, `/referrals`, `/referral-rewards` and `/referral-payouts`.
- Documentation: [Referral Program](https://docs.subscriby.net/creators/referral-program), [the addon](https://docs.subscriby.net/addons/referral-program), [refer a friend, the member's side](https://docs.subscriby.net/subscribers/refer-a-friend).
Files in this package (4)
  • SKILL.md 5 KB
  • references/endpoints.md 23 KB
  • references/events.md 18 KB
  • references/tools.md 20 KB

Versions

RepositoryScoreLicence
This page · envigoinnovations/subscriby-agentic-kit90MIT
TerminalSkills/skills100Apache-2.0
420company/artemis100MIT
alirezarezvani/claude-skills100MIT
The-Utopia-Studio/skills100Apache-2.0
MoizIbnYousaf/marketing-cli100MIT
OpenClaudia/openclaudia-skills100MIT
mkurman/zorai100MIT
varunk130/ai-gtm-skill-library100MIT

Database snapshot: 13.11.2026 · package version 86a7a9a9b6b7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100affiliate-referral-program-stinger
    Design SaaS affiliate and referral programs. Use for platform choice, attribution, commissions, fraud, or program economics. Read README.md for the guide map.
  • 90ambassly-affiliate-program
    Run a Stripe-based affiliate program through the Ambassly MCP. Use when asked to create or update an affiliate program, invite or enrol affiliates, create per-content referral links, review referrals and commissions, or prepare a payout batch.
  • 100affiliate-marketing
    Build and manage an affiliate marketing program. Use when the user says "affiliate program", "affiliate marketing", "affiliate partners", "referral commissions", "affiliate network", "partner program", "affiliate tracking", or asks about creating, managing, or growing an…
  • 85affiliate-page-generator
    When the user wants to create, optimize, or audit affiliate program page content. Also use when the user mentions "affiliate program," "affiliate page," "partner program," "referral program page," "affiliate landing," "partner landing," "commission page," or "affiliate signup."…
  • 100referrals
    When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' 'partner program,' 'referral incentive,'…
  • 100referrals
    When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' 'partner program,' 'referral incentive,'…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.