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.
npx skills add RevenueCat/play-billing-skills --skill plan-changesgit clone --depth 1 https://github.com/RevenueCat/play-billing-skillsWrote 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.
[](https://agentmods.dev/skills/revenuecat/play-billing-skills/plan-changes)<a href="https://agentmods.dev/skills/revenuecat/play-billing-skills/plan-changes"><img src="https://agentmods.dev/badge/skills/revenuecat/play-billing-skills/plan-changes/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.
<a href="https://agentmods.dev/skills/revenuecat/play-billing-skills/plan-changes"><img src="https://agentmods.dev/badge/skills/revenuecat/play-billing-skills/plan-changes.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00069 | $0.01794 |
| Opus 5 | $0.00034 | $0.00897 |
| Sonnet 5 | $0.00014 | $0.00359 |
| Haiku 4.5 | $0.00007 | $0.00179 |
Grade A, and why
plan-changes 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 10d 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.
How it starts
The opening of the file, as written. The whole thing — 170 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Plan Changes: Upgrades, Downgrades, and Plan Switches
Plan changes on Google Play Billing Library (PBL) 9.x always mint a new purchase token. You pick a replacement mode that controls two things: when the user gets access to the new plan, and how Google handles the money between the old and new agreement. This skill walks you through selecting the correct mode and wiring it into BillingFlowParams.
Phase 1: Scope the Change
Before touching code, answer four questions about the requested switch:
- Direction: is this an upgrade (new plan costs more), a downgrade (new plan costs less), or a lateral switch (same price, different cadence)?
- Billing period: are you moving between plans with the same billing period (monthly to monthly) or across periods (monthly to annual, recurring to prepaid)?
- Promotional state: is the user currently inside a free trial or introductory price window that should survive the switch?
- Additivity: is the new SKU replacing the old subscription, or should it sit alongside the old one as an add on?
Write those four answers down. Every decision in Phase 2 follows directly from them.
You also need two inputs from the client at runtime:
oldPurchaseToken: the purchase token for the subscription the user is leaving.ProductDetailsand offer token for the new plan, fetched throughqueryProductDetailsAsync.
If either is missing, stop and fetch it first. Launching the billing flow without a valid oldPurchaseToken produces a new standalone subscription rather than a plan change.
Phase 2: Plan the Replacement Mode
PBL 9.x exposes replacement modes through the ReplacementMode interface. UNKNOWN is deprecated; do not select it. The five modes you actually pick from are listed below, along with KEEP_EXISTING which arrived in PBL 8.1 for add on bundles.
Mode Decision Table
Use this table to map your Phase 1 answers to a mode.
| Scenario | Recommended Mode | Immediate Charge? | Access Switch |
|---|---|---|---|
| Standard upgrade, fair to user | WITH_TIME_PRORATION |
No | Immediate, renewal shifts forward |
| Upgrade, keep renewal date stable | CHARGE_PRORATED_PRICE |
Yes, prorated difference | Immediate, renewal unchanged |
| Switch to or from a prepaid plan | CHARGE_FULL_PRICE |
Yes, full new price | Immediate |
| Upgrade during a free trial or intro price | WITHOUT_PRORATION |
No, settles at next renewal | Immediate, trial preserved |
| Downgrade | DEFERRED |
No | At next renewal |
| Subscription add on, both plans active | KEEP_EXISTING |
Yes, new plan charged | Immediate, existing plan untouched |
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.
- 10d ago First seen · 170 lines · 69 tokens per session scan A 0d27537b9706
plan-changes is a skill published in the GitHub repository RevenueCat/play-billing-skills (53 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 69 tokens to every session and 1,794 once invoked, about $0.0003 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.
Other skills, from other repositories
play-billing-library-version-upgrade
Use this skill when upgrading or migrating an Android project from any legacy Google Play Billing Library (PBL) version to the latest stable version of PBL.
asc-revenuecat-catalog-sync
Reconcile App Store Connect subscriptions and in-app purchases with RevenueCat products, entitlements, offerings, and packages using asc and RevenueCat MCP. Use when setting up or syncing subscription catalogs across ASC and RevenueCat.
axiom-implement-iap
Use when the user wants to add in-app purchases, implement StoreKit 2, or set up subscriptions.
google-play
Google Play Developer API (Android Publisher) integration with managed OAuth. Manage apps, subscriptions, in-app purchases, and reviews. Use this skill when users want to interact with Google Play Console programmatically. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
subscription-lifecycle
Generates StoreKit 2 subscription lifecycle management — grace periods, billing retry, offer codes, win-back offers, upgrade/downgrade paths, and subscription status monitoring. Use when user needs post-purchase subscription state handling beyond the initial paywall.
subscription-offers
Generates StoreKit 2 code for all subscription offer types — introductory, promotional, offer codes, and win-back. Includes eligibility checks, offer presentation, and the preferredSubscriptionOffer modifier. Use when adding subscription offers, free trials, or promotional pricing.