referral-program

referral-program is a skill for Claude Code from Eronred/aso-skills. It costs 159 tokens per session (1,981 once invoked), scanned A, original, MIT.

A guide for designing and improving an in-app referral program, where existing users invite other people and may receive rewards.

In plain words
What is it for?
Use it to plan invite flows, reward rules, fraud controls, deep links, and measurements such as the number of new users generated by referrals.
Why use it?
It helps you choose workable rewards and sharing mechanics while considering fraud, costs, links, and measurement.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: positional $N argument.

Part of the aso-skills plugin — 40 skills shipped together

Good fit Use it to plan invite flows, reward rules, fraud controls, deep links, and measurements such as the number of new users generated by referrals.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/eronred/aso-skills/referral-program
About the project

ASO & App Marketing Skills is a collection of AI-agent skills for improving mobile-app discoverability and marketing through keyword research, metadata optimization, competitor analysis, and market data. It is for indie developers, app marketers, and growth teams using compatible coding agents, and the catalogue contains the skills and instructions they use.

Eronred/aso-skills · 1,835 stars · on GitHub · appeeky.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Eronred/aso-skills --skill referral-program
Clone the repo
git clone --depth 1 https://github.com/Eronred/aso-skills

Made for: Claude Code.

Or install aso-skills, the plugin that ships this one along with the rest of its 40 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for referral-program

README.md
[![agentmods](https://agentmods.dev/badge/skills/eronred/aso-skills/referral-program/github.svg)](https://agentmods.dev/skills/eronred/aso-skills/referral-program)
Your own site
<a href="https://agentmods.dev/skills/eronred/aso-skills/referral-program"><img src="https://agentmods.dev/badge/skills/eronred/aso-skills/referral-program/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for referral-program

Your own site · 80×15
<a href="https://agentmods.dev/skills/eronred/aso-skills/referral-program"><img src="https://agentmods.dev/badge/skills/eronred/aso-skills/referral-program.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 159 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,981 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 8 May 2026
  • Snyk pass 8 May 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00159 $0.01981
Opus 5 $0.00079 $0.00991
Sonnet 5 $0.00032 $0.00396
Haiku 4.5 $0.00016 $0.00198

Measured 9d ago against content hash b4f565ba3f1c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

referral-program scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

5 near-identical copies found in the catalogue:

skills/referral-program/SKILL.md · 173 lines

How it starts

The opening of the file, as written. The whole thing — 173 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Referral Program

You are a referral / viral growth specialist. Your goal is to help the user ship a referral program that drives a measurable lift in install volume — typically 5–20% of net-new installs once mature — without inviting fraud or eroding unit economics.

Initial Assessment

  1. Check for app-marketing-context.md
  2. Ask: What's the core value users would invite friends for? (multiplayer, shared workspace, social, savings, status)
  3. Ask: What's your CAC for a paid install? (sets the upper bound on referral reward)
  4. Ask: What's your ARPU / LTV for a converted user?
  5. Ask: Do you have an MMP / deep link infra already? (Branch, AppsFlyer OneLink, Adjust)
  6. Ask: Target audience — does the product have natural sharing moments?

If LTV is unclear, route to asc-metrics first. You can't size rewards without knowing payback.

Is a Referral Program Right for You?

Strong fit Weak fit
Network-effect product (chat, social, multiplayer, marketplaces) Solo-use utilities with no sharing moment
High LTV / paid users Low ARPU free apps where rewards aren't affordable
Content / progress that users want to show off Apps users are embarrassed to use
Recurring engagement (daily-use) One-and-done utilities
Existing organic word-of-mouth No organic sharing happening today

If "weak fit," steer the user toward creator-ugc-marketing or retention-optimization instead.

Reward Structure Patterns

Pattern How it works Best for
Double-sided ($X for both inviter + invitee) Most common, fairest Most consumer apps
Inviter-only Sender gets reward, invitee gets nothing Apps with strong organic install motivation
Invitee-only New user gets discount/bonus, inviter doesn't Cold acquisition, when virality isn't core goal
Tiered / milestone ("Invite 5 friends, get a year free") Bigger rewards at milestones Power users, status seekers
Currency / credits (in-app currency for both) No real cash leaves the company Games, content apps with IAP
Status / cosmetic (badge, theme, avatar) Social products; cost ~$0 Social apps, communities
Cash / payouts Direct money to user Fintech, marketplaces; high fraud risk

Read the full file on GitHub · 173 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 173 lines · 159 tokens per session scan A b4f565ba3f1c

Subscribe to this mod's changes

referral-program is a skill published in the GitHub repository Eronred/aso-skills (1,835 stars, last pushed 17d ago), licensed MIT. It adds 159 tokens to every session and 1,981 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

asc-app-create-ui

Create an App Store Connect app via iris API using web session from Blitz.

blitzdotdev/blitz-mac · 19 tokens

aso-playbook

Beginner-friendly App Store Optimization guide covering keyword research, screenshot design, rating management, and A/B testing for iOS and Android. By @WeiYipei — practical ASO for indie developers and small teams.

Gingiris-1031/gingiris-skills · 48 tokens

gingiris-aso-growth

A broad guide to growing mobile apps through App Store Optimization, launch planning, creator-made content, and marketing on platforms such as TikTok, Instagram, and YouTube Shorts.

Gingiris-1031/gingiris-skills · 320 tokens

gr-aso

A skill for app-store optimization, or improving how an app is found and presented in the App Store and Google Play, plus launch planning for a new app. It covers listing text, screenshots and video, ratings, creator content, advertising, and localization.

Gingiris-1031/gingiris-skills · 56 tokens

site-to-ios-app

Use when converting any website, web app, PWA, SaaS dashboard, content site, or marketplace into an iOS app using the public Suede-originated site-to-iOS workflow. Covers URL audit, App Store 4.2 wrapper-risk checks, Capacitor or native-shell strategy, native value requirements, iOS build scaffolding, screenshots…

JasonColapietro/ios-app-dev-skills · 85 tokens

ios-screenshot-taker

Use when capturing deterministic iOS simulator screenshots for App Store, TestFlight, QA, launch pages, or marketing decks. Covers xcodebuild build, simulator boot/install/launch, seeded demo states, xcrun simctl screenshots, required App Store device classes, public-safe output handling, and slash commands such as…

JasonColapietro/ios-app-dev-skills · 78 tokens