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.

9 stars 2 forksFrontend & Design Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add PaddleHQ/paddle-agent-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add PaddleHQ/paddle-agent-skills --skill paddle-subscription-update
Manual install
git 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-update

Personal 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.
Read the full skill on GitHub

Details

Skill name
paddle-subscription-update
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

9

PaddleHQ/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).

Documents & Office Files

Paddle Catalog Setup

9

PaddleHQ/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.

Software Development

Paddle Checkout Web

9

PaddleHQ/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.

Frontend & Design

Paddle Usage Based Billing

9

PaddleHQ/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.

Frontend & Design

Paddle Subscription Cancel

9

PaddleHQ/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.

Frontend & Design

Wp Accessibility

9

morrealev/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.

Frontend & Design

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.