Paddle Subscription Update
Change a Paddle subscription's plan from a Next.js Server Action — auth, ownership check, `prorationBillingMode`, items-array replace semantics, preview-before-commit, and `on_payment_failure` handling.
Install
/plugin marketplace add PaddleHQ/paddle-agent-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add PaddleHQ/paddle-agent-skills --skill paddle-subscription-updategit clone --depth 1 https://github.com/PaddleHQ/paddle-agent-skills.git /tmp/paddle-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/paddle-agent-skills/providers/claude/plugin/skills/subscription-update ~/.claude/skills/paddle-subscription-updatePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Update a Paddle subscription's plan from Next.js ## When to use this skill Use this skill when building "Upgrade plan," "Switch tier," or "Change subscription" actions in your authenticated user's billing UI. It covers a Next.js 15 (App Router) Server Action that calls `paddle.subscriptions.update()`, the five `prorationBillingMode` choices and when to pick each, the _replace not append_ semantics of the items array, and the security checks every plan-change action needs. This is the _initiating_ side of subscription changes. Pair it with: - `subscription-sync` — your webhook handler will get a `subscription.updated` event after the change. Your DB mirror picks up the new plan, status, and pricing. - `subscription-cancel` — same auth/ownership shape; if you're building both, share the helpers. ## Prerequisites - A Paddle account with **at least two prices** the user can switch between (e.g. monthly Starter and monthly Pro). Sandbox is fine. - Server-side `PADDLE_API_KEY` available — Server Action only. The key needs the `subscription.write` permission (for `update` and `activate`). `previewUpdate` only needs `subscription.read`, which `write` includes. - Customer + subscription state mirrored from webhooks (see `subscription-sync`). - An auth system. Examples use Supabase.
Details
- Skill name
paddle-subscription-update- Repository
- PaddleHQ/paddle-agent-skills
- Path
providers/claude/plugin/skills/subscription-update/SKILL.md- License
- Apache-2.0
- Repo updated
- 18 November 2026
FAQ
What does the Paddle Subscription Update skill do?
Change a Paddle subscription's plan from a Next.js Server Action — auth, ownership check, `prorationBillingMode`, items-array replace semantics, preview-before-commit, and `on_payment_failure` handling.
How do I install the Paddle Subscription Update skill?
Claude Code plugin: /plugin marketplace add PaddleHQ/paddle-agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Paddle Subscription Update popular?
It lives in PaddleHQ/paddle-agent-skills, which has 9 GitHub stars and 2 forks.
Related skills
Paddle Billing History
9PaddleHQ/paddle-agent-skills
Render the authenticated user's billing history in Next.js — listing transactions via the Paddle Node SDK, the mandatory customer-id filter, pagination via `.next()`/`.hasMore`, status filtering, on-demand invoice PDF links, and formatting raw transaction totals (lowest-unit conversion + Intl.NumberFormat, with the zero-decimal currency special case for JPY/KRW/VND/CLP).
Paddle Catalog Setup
9PaddleHQ/paddle-agent-skills
Create the Paddle products and prices that other Paddle skills depend on — try MCP tools first, then the Paddle CLI, fall back to a Node SDK seed script, or dictate dashboard steps as a last resort.
Paddle Checkout Web
9PaddleHQ/paddle-agent-skills
Add a Paddle Checkout to a Next.js web app — overlay or inline, with event handling, customer pre-fill, and dynamic line item updates.
Paddle Usage Based Billing
9PaddleHQ/paddle-agent-skills
Add Paddle usage-based billing (early access) to a Next.js app — early access check, usage balance units, meters, price allowances, usage events, balance gating, and `usage_balance.depleted`, using the Paddle API directly.
Paddle Subscription Cancel
9PaddleHQ/paddle-agent-skills
Cancel a Paddle subscription from a Next.js Server Action — auth, ownership check, safe `effectiveFrom` default, revalidation, and the `canceled` vs `scheduledChange` distinction.
Wp Accessibility
9morrealev/wordpress-manager
Use when improving WordPress accessibility: block accessibility (ARIA, keyboard navigation), theme accessibility (landmarks, skip links, color contrast), interactive component accessibility, media accessibility (alt text, captions, transcripts), and automated/manual a11y testing with WCAG 2.2 compliance.
Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.