Skip to main content

subscription-plan-changes

Analyzes subscription upgrades, downgrades, prorations, and plan migrations in Stripe. Use when the user mentions "upgrade", "downgrade", "plan change", "proration", or "switching tiers".

Jump to install

Source facts

Repository
appeeky/stripe-skills
Last source activity
July 19, 2026 at 10:10
Detected SKILL.md language
English
Stars
5
Forks
1

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions ยท Read-only preview
name
subscription-plan-changes
description
Analyzes subscription upgrades, downgrades, prorations, and plan migrations in Stripe. Use when the user mentions "upgrade", "downgrade", "plan change", "proration", or "switching tiers".
metadata
{"version":"1.0.0"}
# Subscription Plan Changes ## Stripe MCP Setup Requires **Stripe MCP** connected via OAuth or restricted key. Docs: https://docs.stripe.com/mcp 1. `GetMcpTools` with `server: "user-Stripe"` (or `plugin-stripe-stripe`) before any call 2. Prefer `stripe_api_search` โ†’ `stripe_api_details` โ†’ `stripe_api_read` for list/retrieve 3. **Always paginate** โ€” `limit: 100`, follow `has_more` with `starting_after` 4. Amounts are in **cents** unless noted 5. Never expose secret keys in output ## Workflow 1. Review codebase checkout update path (`subscriptions.update` vs new checkout) 2. Sample recent `customer.subscription.updated` โ€” compare `items` price changes 3. Check proration: `proration_behavior`, invoice line items for `proration` ## Anti-Patterns - Creating **new** subscription instead of updating โ†’ double billing - No `alreadyOnPlan` guard ## Output Template ``` Plan Change Audit Update method: in-place / new checkout Proration: [behavior] Recent migrations (sample): | Customer | From โ†’ To | Proration $ | Recommendations: ... ```
View on GitHub