Sandbox
@heliocosta-dev/revenue-centric-design

Agent skill for SaaS conversion and pricing principles

This skill packages 134 revenue-centric design principles for SaaS products. It loads themed reference files so your agent can answer with the right conversion, onboarding, pricing, retention, or experimentation principle when you need it.

680 stars56 forksPythonUpdated 13d ago
Who it's for

Builders who want their agent to help design SaaS products that convert, retain, and monetize better.

What it delivers

You can give your agent a reusable playbook for making product and growth decisions with behavioral-science and CRO principles.

What it does

Themed principle library

Splits 134 principles into themed reference files for conversion, checkout, onboarding, pricing, churn, dashboards, strategy, and more.

Progressive disclosure

Loads only the theme relevant to your question instead of dumping the whole playbook at once.

Fixed principle format

Each principle follows the same structure: Principle, Apply when, The move, Evidence, Visual, and Source.

Agent-skills packaging

Installs as an Agent Skill and works with skills-compatible agents through `npx skills add`.

Usage boundary

Includes an explicit rule that the material must not be used for gambling, betting, or casino products.

How to get it

  1. 1Run
    npx skills add heliocosta-dev/revenue-centric-design
  2. 2Or install it manually
    git clone https://github.com/heliocosta-dev/revenue-centric-design.git ~/.claude/skills/revenue-centric-design

README

Revenue-Centric Design — an Agent Skill

Agent Skill Principles Themes Updated

A distilled, English-language playbook for designing SaaS & startup products that convert, retain, and monetize — packaged as an Agent Skill for Claude Code, Cursor, Codex, Copilot, Gemini, and any skills.sh-compatible agent.

134 principles distilled from the X/Twitter writing of Richard (@richardrx) — a product designer specializing in conversion-rate optimization, churn reduction, and applied behavioral science (ex-Volkswagen, ex-PayPal, ex-IBM). The throughline is his coined philosophy, Revenue-Centric Design (RCD): design should serve the user and the business — value and revenue, not one or the other.

Last updated: 3 September 2026 Coverage: @richardrx's curated posts from 3 Nov 2025 → 26 Aug 2026 (136 posts). Anything posted after this date is not yet included — see Updating.

Install

npx skills add heliocosta-dev/revenue-centric-design

This pulls the skill into your agent's skills directory (.claude/skills/, .agents/skills/, …) and works with any Agent Skills–compatible agent.

Already installed it? Pull the latest version with npx skills update revenue-centric-design (or a bare npx skills update to refresh every installed skill). The command re-fetches from GitHub; your agent picks up the new content on its next session.

Or install it manually:

git clone https://github.com/heliocosta-dev/revenue-centric-design.git ~/.claude/skills/revenue-centric-design

⚠️ Usage boundary

🚫 Not for betting, casino, or gambling products. The author granted permission to reuse this material on the explicit condition that it is never used for gambling/betting/casino work (including loot-box / real-money-gaming mechanics). The skill instructs agents to decline such requests. See LICENSE.

What's inside

The skill loads only the theme relevant to your question (progressive disclosure). Each principle follows a fixed shape — Principle → Apply when → The move → Evidence → Visual → Source — so your agent gets the named lever (decoy effect, Swiss Knife Index, GBB, Eugene Schwartz's awareness levels, loss aversion, peak-end rule…), the concrete action, and the proof.

ThemePrinciplesCovers
Conversion & Landing Pages24hero/copy, CTAs, social proof, awareness levels, CRO
Checkout & Forms5checkout, lead forms, cart abandon, field friction
Onboarding & Activation20empty states, aha moment, TTV, activation, trials
Revenue-Centric Design13the RCD principles, design process & method
Pricing & Monetization15decoy/anchoring, GBB, trial-with-card, upgrades
Churn & Retention13cancellation UX, expectation debt, NRR, JTBD
Dashboards & Data Visualization3KPIs, actionable panels, F-pattern, role context
Behavioral Science Toolkit7the cross-cutting biases & persuasion levers
Product Strategy & Features13Swiss Knife Index, feature adoption, attention
Positioning, ICP & GTM8ICP, niche, TAM/SAM/SOM, PLG, first customers
AI-Era Differentiation7moats, commoditization, vibe-coding pitfalls
Metrics & Experimentation6A/B rigor, vanity metrics, churn→LTV math

The agent entry point is SKILL.md; informational diagrams referenced by the principles live in assets/.

The spine: RCD in 9 principles

  1. Neutrality is omission — an interface that doesn't direct hurts conversion.
  2. Who talks to everyone convinces no one — no ICP → generic value → worse retention.
  3. Value first, ask later — proof must arrive before the user questions their choice.
  4. Your promise is the size of your proof — the market believes what you demonstrate, not what you claim.
  5. Same competes on price, different on category — no contrast, no margin.
  6. Default is the decision you made for the user — the initial state defines mass behavior.
  7. Retention is built, not requested — perceived loss retains more than promised benefit.
  8. Expansion is born of usage — upgrade at the moment of the limit, never by interruption.
  9. Price is a filter — pricing defines who enters, who stays, and who expands.

Updating

This is a point-in-time snapshot. The Coverage date above marks the latest included post (26 Aug 2026); anything newer from @richardrx isn't here yet. To extend it: gather the newer posts, distill each into the same principle shape, file it under the right references/ theme, then bump the dates in this README and in CHANGELOG.md.

Provenance & attribution

All ideas, frameworks, examples, and the coined term Revenue-Centric Design belong to Richard (@richardrx). This repository is a curated, distilled, English-translated index of 136 of his public X posts, created with his permission for educational reference. Every principle links back to its original post, and it reproduces distilled principles rather than his full posts verbatim.

License

Source-available under custom terms — attribution required, no gambling/betting/casino use. See LICENSE. The underlying ideas remain the author's.

Files in the repo

Repository payload8 top-level entries
  • assets
  • references
  • updater
  • .gitignore
  • CHANGELOG.md
  • LICENSE
  • README.md
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

86k

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k
img2threejs/
img2threejs

Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.

16k