Referral Program
freekmurze/dotfiles
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.
Designing free-to-paid conversion flows for SaaS products. An agent skill from rampstackco/claude-skills.
$ npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install rampstackco/claude-skills upgrade-flow-design --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/upgrade-flow-design .claude/skills/upgrade-flow-design && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "upgrade-flow-design" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/upgrade-flow-design into .claude/skills/upgrade-flow-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upgrade-flow-design", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/rampstackco/claude-skills/tree/main/skills/upgrade-flow-designType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install rampstackco/claude-skills upgrade-flow-design --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/upgrade-flow-design .agents/skills/upgrade-flow-design && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "upgrade-flow-design" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/upgrade-flow-design into .agents/skills/upgrade-flow-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upgrade-flow-design", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install rampstackco/claude-skills upgrade-flow-design --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/upgrade-flow-design .cursor/skills/upgrade-flow-design && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "upgrade-flow-design" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/upgrade-flow-design into .cursor/skills/upgrade-flow-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upgrade-flow-design", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/rampstackco/claude-skills.git --path skills/upgrade-flow-design--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install rampstackco/claude-skills upgrade-flow-design --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/upgrade-flow-design .gemini/skills/upgrade-flow-design && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "upgrade-flow-design" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/upgrade-flow-design into .gemini/skills/upgrade-flow-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upgrade-flow-design", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install rampstackco/claude-skills upgrade-flow-designInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/upgrade-flow-design .github/skills/upgrade-flow-design && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "upgrade-flow-design" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/upgrade-flow-design into .github/skills/upgrade-flow-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upgrade-flow-design", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install rampstackco/claude-skills upgrade-flow-design --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/upgrade-flow-design .opencode/skills/upgrade-flow-design && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "upgrade-flow-design" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/upgrade-flow-design into .opencode/skills/upgrade-flow-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "upgrade-flow-design", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
upgrade-flow-designDesigning free-to-paid conversion flows for SaaS products. An agent skill from rampstackco/claude-skills.
Upgrade Flow Design is an agent skill from rampstackco/claude-skills. Designing free-to-paid conversion flows for SaaS products. Trigger moments, paywall design, value demonstration, upsell vs downsell, win-back flows, churn prevention. Honest about paywall-everywhere (gates everything aggressively), free-forever-trap (no upgrade path surfaces), and value-triggered-upgrade (paywall surfaces at moments of demonstrated value) patterns. Triggers on upgrade flow, paywall, free-to-paid, freemium conversion, trial conversion, plan upgrade, subscription upgrade, win-back flow, churn…
Its SKILL.md is about 4.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `README.md`, `references/churn-prevention-upstream.md` and `references/common-upgrade-failures.md`).
It sits in Marketing & SEO, covering Referral and retention marketing. The repository describes itself as: Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, content, SEO, dev, ops, growth, and research. Build, ship, audit, optimize. The licence is MIT.
12 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 482c9bf. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Upgrade Flow Design loads about 4.6k tokens when it runs, and up to ~21k if it reads all its reference files. Until then it costs about 175 tokens; SKILL.md has 2,206 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from rampstackco/claude-skills at commit 482c9bf, republished under its MIT licence (© rampstackco). 2,206 words, ~4,593 tokens.
.claude/skills/upgrade-flow-design/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.A senior product marketing director's playbook for designing free-to-paid conversion flows in SaaS products. Trigger moments, paywall design, value demonstration, upsell vs downsell, win-back flows, churn prevention. The discipline of asking for the upgrade at the moment the user has a reason to say yes.
Most upgrade flows fail in one of two ways. They block meaningful product use behind paywalls so aggressively that users churn before reaching the moment that would justify paying. Or they offer a generous free tier with no upgrade path that ever surfaces; users get everything they need; conversion stays at single-digit percentages indefinitely.
The upgrade flows that work do something different. They surface paywalls at moments where the user has demonstrably gotten value. The user has hit a usage threshold, completed a flow, or otherwise demonstrated they are getting the product's promise. The upgrade ask is honest about what they get next; the user is positioned to say yes because the value is fresh.
The voice is the senior product marketing director who has watched conversion rates double when paywalls were re-timed and watched them collapse when more aggressive paywalls were added. Practical, opinionated about the moments that earn the upgrade ask, willing to call out when the product's free tier is too generous to convert.
When to use this skill: scoping a free-to-paid conversion flow for the first time, auditing paywalls that block conversion or never surface, designing the trigger moments that earn upgrade asks, or deciding plan structure that supports upgrades over time.
This skill spans free-to-paid conversion flows in SaaS products. The growth-tooling distinctions:
lead-magnet-design is top-of-funnel email capture. This skill is free-to-paid conversion in-product.funnel-flow-architecture is the cross-tool funnel architecture. This skill is the upgrade flow specifically.upgrade-flow-design (this skill) is trigger-moment design, paywall presentation, plan structure, win-back, churn prevention.landing-page-copy is pricing-page copy; lives downstream of this skill's plan-structure decisions.pm-spec-writing is the spec for engineers building the upgrade flow.The audience: product marketers, growth marketers, in-house product teams, agencies running SaaS conversion work for clients.
Out of scope: cross-funnel architecture (covered by funnel-flow-architecture); pricing-page copy (covered by landing-page-copy); the engineering implementation; specific Stripe/Chargebee/Recurly/Paddle billing-platform configurations (those stay implementation-side).
Before designing the upgrade flow, decide the free-tier structure.
Freemium (free-forever tier).
When it works: products with strong network effects, or where free users provide product value (data, content, virality).
Free-trial (time-limited).
When it works: products where the value is clear quickly; audiences willing to commit time before paying.
Reverse trial.
No-free (paid-only).
When it works: enterprise products, high-touch sales, products where free would dilute brand or capacity.
The decision is upstream of upgrade flow design. Different free-tier structures warrant different upgrade flows.
Detail in references/free-tier-decision-criteria.md.
The keystone framing.
Paywall-everywhere. Paywall blocks meaningful product use. Free tier exists but is too constrained to demonstrate value. Users churn before reaching the moment that would justify paying. Cost: users who would have paid after seeing value never reach that moment; conversion suffers despite aggressive paywalling.
Free-forever-trap. Generous free tier with no upgrade path that ever surfaces. Users get everything they need; never see why they would pay. Conversion rate stays at single-digit percentages indefinitely. Cost: the team has built a product users like for free; revenue does not follow because the upgrade ask never lands.
Value-triggered-upgrade. Paywall surfaces at moments where the user has demonstrably gotten value. The user has hit a usage threshold, completed a flow, or otherwise demonstrated they are getting the product's promise. The upgrade ask is honest about what they get next. Cost: design effort upfront is significant; conversion typically meaningfully higher than either alternative.
The litmus test. After a user encounters the upgrade flow, can they articulate why they should pay? "Because I just hit my limit on this feature I have used 200 times" is value-triggered. "Because the product told me to pay before letting me use it" is paywall-everywhere. "I have not seen an upgrade ask" is free-forever-trap.
The single most consequential decision in upgrade flow design.
The principle. Paywalls surface at moments where the user has demonstrated they are getting the product's value. The interruption is justified because the user has a reason to say yes.
Strong trigger moments.
Weak trigger moments.
The discipline. Each paywall should answer: what value did the user just demonstrate, and how does the paid plan extend that value?
Detail in references/trigger-moment-design.md.
How the paywall surfaces.
Pattern A: Modal paywall. Full-screen overlay blocks the action; user must upgrade or dismiss.
When to use. Capacity limits, feature gates the user has hit. The interruption is warranted by the trigger.
Pattern B: Banner paywall. Persistent banner at top of page suggesting upgrade.
When to use. Soft prompts; awareness without interruption. Risk of becoming visual noise.
Pattern C: Inline paywall. Upgrade ask embedded in the surface where the trigger occurred.
When to use. Contextual prompts that integrate with the workflow.
Pattern D: Toast or notification. Brief paywall surfaced as a notification.
When to use. Soft prompts; low-priority upgrade asks.
Choice criteria.
Copy and value-prop discipline.
Detail in references/paywall-presentation-patterns.md.
When the user does not accept the primary upgrade.
Upsell. User is on basic plan; ask them to upgrade to higher tier.
Cross-sell. User is paying; offer add-ons or related products.
Downsell. User declined the higher tier; offer a smaller commitment (smaller plan, monthly vs annual, basic vs full feature set).
The downsell discipline. Some users will not upgrade to the proposed tier but will upgrade to something. Downsell captures revenue otherwise lost.
Examples.
Anti-pattern. Aggressive downsell that makes the user feel manipulated. Honest framing: "If Pro is more than you need, here is something that fits."
Detail in references/upsell-vs-downsell-logic.md.
Lapsed users, downgrades, partial-churn.
Win-back triggers.
Win-back patterns.
Discount discipline.
Detail in references/win-back-flow-patterns.md.
The best upgrade flow is the one the user does not need because they did not churn.
Upstream churn signals.
Prevention patterns.
The prevention-vs-recovery economics. Preventing churn is much cheaper than winning back churned users. Invest upstream.
Detail in references/churn-prevention-upstream.md.
The plans that the upgrade flow leads to.
Tier count.
Feature gating.
Discipline. Each tier should have a clear "this is for [X audience] because of [Y]." Tiers without clear audience-fit produce weak conversions.
Pricing-page design. The pricing page is downstream of plan structure but lives close to upgrade flow. Detail in landing-page-copy for pricing-page copy specifically.
Detail in references/plan-structure-patterns.md.
Rapid-fire. Diagnoses in references/common-upgrade-failures.md.
When designing or auditing an upgrade flow, walk these 12 considerations.
The output of the framework is an upgrade flow that earns the user's "yes" by asking at the moment the user has a reason to say yes, with plan structure that fits the audience the product serves.
references/free-tier-decision-criteria.md - Freemium, free-trial, reverse trial, no-free. Choice criteria.references/trigger-moment-design.md - Where paywalls earn their interruption. Strong vs weak trigger moments.references/paywall-presentation-patterns.md - Modal, banner, inline, toast. Copy and value-prop discipline.references/upsell-vs-downsell-logic.md - When primary upgrade is declined, secondary paths.references/win-back-flow-patterns.md - Lapsed users, downgrades, partial-churn re-engagement.references/churn-prevention-upstream.md - Preventing churn before the upgrade flow is needed.references/plan-structure-patterns.md - Tier count, feature gating, audience-fit per tier.references/upgrade-flow-anti-patterns.md - The patterns that look like upgrade flows but degrade trust.references/common-upgrade-failures.md - 9+ failure patterns with diagnoses and cures.The upgrade flows that compound revenue are the ones that ask at the moment the user has a reason to say yes. Not because the paywall blocked them. Not because the upgrade prompt happened to appear. Because the user just did something that demonstrated value, and the upgrade ask connected that value to continued or expanded access.
That is the bar. Below the bar are paywall-everywhere (gates before value, conversion suffers) and free-forever-trap (no upgrade path, conversion never starts). Above the bar are value-triggered-upgrade flows where trigger-moment design, paywall presentation, plan structure, win-back, and churn prevention work together to convert the right users at the right moments.
The discipline is in the design choices. The free-tier decision (freemium, trial, paid-only) sets the funnel shape. Trigger-moment design decides when paywalls earn their interruption. Paywall presentation decides how the ask lands. Plan structure decides what the user is upgrading to. Win-back and churn prevention catch the cases that escaped the primary upgrade flow.
© rampstackco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 10 other files (references) in skills/upgrade-flow-design of rampstackco/claude-skills.
Open the folder on GitHubat commit 482c9bf
Upgrade Flow Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Upgrade Flow Design this skillrampstackco/claude-skills | 935 | — | ~4.6k | Automated safety check: Pass | MIT | |
| Referral Programfreekmurze/dotfiles | 1k | 16 repos | ~1.8k | Automated safety check: Pass | None | |
| Churn Preventionrongxinzy/RongxinAI | 154 | 3 repos | ~2.6k | Automated safety check: Pass | MIT | |
| 100m Leadsgetagentseal/founder-playbook | 721 | — | ~2.3k | Automated safety check: Pass | MIT | |
| Churn Preventionfreekmurze/dotfiles | 1k | 12 repos | ~4.4k | Automated safety check: Pass | None | |
| ReferralsCesarjoquin/Marketing-Skills | 199 | 1 repos | ~1.9k | Automated safety check: Pass | MIT |
freekmurze/dotfiles
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.
rongxinzy/RongxinAI
Reduce voluntary and involuntary churn through cancel flow design, save offers, exit surveys, and dunning sequences.
getagentseal/founder-playbook
Builds lead generation systems using Alex Hormozi's Core Four framework (warm outreach, content, cold outreach, paid ads), lead magnets, and Rule of 100.
freekmurze/dotfiles
When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies.
Cesarjoquin/Marketing-Skills
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.
aaron-he-zhu/aaron-marketing-skills
A skill your agent uses when the user asks to "design a welcome flow", "set up an abandoned-cart sequence", "build a light re-engagement branch inside a lifecycle flow", or "plan a cold-outbound…
rampstackco/claude-skills
Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.
rampstackco/claude-skills
Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.
rampstackco/claude-skills
Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts.
rampstackco/claude-skills
Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.
rampstackco/claude-skills
Write or edit website copy, blog content, and editorial pieces with attention to voice, structure, and goal.
rampstackco/claude-skills
Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning.
Categories
Designing free-to-paid conversion flows for SaaS products. An agent skill from rampstackco/claude-skills. Upgrade Flow Design is an agent skill from rampstackco/claude-skills. Designing free-to-paid conversion flows for SaaS products.
Upgrade Flow Design fits situations like: value demonstration; upsell vs downsell; churn prevention; freemium conversion.
Run `npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a claude-code`. Or copy the skill folder (skills/upgrade-flow-design in rampstackco/claude-skills) into .claude/skills/upgrade-flow-design in your project. Claude Code loads it when a task matches its description.
Run `npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a codex`. Or copy the skill folder (skills/upgrade-flow-design in rampstackco/claude-skills) into .agents/skills/upgrade-flow-design in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rampstackco/claude-skills --skill upgrade-flow-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/upgrade-flow-design, .gemini/skills/upgrade-flow-design, .github/skills/upgrade-flow-design and .opencode/skills/upgrade-flow-design in your project.
SKILL.md names no scripts, command-line tools or credentials: Upgrade Flow Design is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Upgrade Flow Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 4.6k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 16k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Upgrade Flow Design: Referral Program (freekmurze/dotfiles, 1k stars), Churn Prevention (rongxinzy/RongxinAI, 154 stars), 100m Leads (getagentseal/founder-playbook, 721 stars) and Churn Prevention (freekmurze/dotfiles, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
rampstackco (a GitHub organization) maintains it in rampstackco/claude-skills, which has 935 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.
Source: rampstackco/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.