plan-change-handling

Automate SaaS subscription plan changes with Stripe proration and entitlement sync.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/marquesfelip/agents-and-skills --skill plan-change-handling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-change-handling
Source: https://github.com/marquesfelip/agents-and-skills/tree/main/skills/plan-change-handling
Command: npx skills add https://github.com/marquesfelip/agents-and-skills --skill plan-change-handling

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrades, downgrades, seat changes, and billing-interval switches for SaaS subscriptions require precise proration, timing, and entitlement updates to avoid revenue leakage and customer confusion.

Core Features & Use Cases

  • Upsert upgrade/downgrade flows with Stripe PRORATE behavior, including immediate upgrades and end-of-period downgrades.
  • Manage per-seat plans with dynamic quantity adjustments and correct proration behavior for additions/removals.
  • Schedule and surface pending downgrades at the next renewal, with opt-in visibility for customers.
  • Handle billing-interval switches (monthly to annual and vice versa) with correct price transitions and anchor resets.
  • Emit or synchronize entitlement updates and analytics events to reflect plan changes.

Quick Start

Upgrade a tenant's plan immediately and apply proper proration and entitlement updates.

Frequently Asked Questions about plan-change-handling

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle Stripe subscription proration for plan upgrades and downgrades?

Stripe subscription proration for plan upgrades and downgrades is automated by configuring immediate upgrade flows and scheduling end-of-period downgrades. This process applies precise billing transitions and synchronizes entitlements to prevent revenue leakage.

What is the best way to manage per-seat quantity adjustments with Stripe billing?

Per-seat quantity adjustments with Stripe billing are managed by applying dynamic proration logic to seat additions and removals. This method calculates accurate intermediate charges and updates subscription quantities to prevent billing discrepancies.

How do I schedule a pending downgrade to take effect at the next renewal period?

Pending downgrades at the next renewal period are scheduled by tracking the billing cycle transition and deferring the plan change. This grants customers opt-in visibility into the pending switch while maintaining current entitlements until the renewal date.

Can I switch a SaaS billing interval from monthly to annual and reset the billing anchor?

Switching a SaaS billing interval from monthly to annual is fully supported with correct price transitions and billing anchor resets. This functionality updates the subscription term and applies the new billing cycle automatically.

Does this approach synchronize entitlements and analytics events when a subscription changes?

Entitlements and analytics events are synchronized upon subscription changes by emitting updates that reflect the new plan limits. This ensures user access levels and internal metrics accurately match the active subscription state immediately after modification.

Why does SaaS revenue leakage occur during subscription plan changes?

SaaS revenue leakage during subscription plan changes occurs due to imprecise proration timing and unsynchronized entitlement updates. Automating the upgrade and downgrade workflows with accurate billing calculations closes these timing gaps and prevents customer confusion.