Paddle Usage Based Billing
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.
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-usage-based-billinggit 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/usage-based-billing ~/.claude/skills/paddle-usage-based-billingPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Add usage-based billing to a Next.js app (early access) ## When to use this skill Use this skill when the user wants subscription plans that include prepaid usage — like 10,000 API calls, 1 million tokens, or 500 document exports a month — and wants to report usage to Paddle and restrict features when customers run out. Pair with: - `catalog-setup` — create the product. Create prices with allowances using this skill's API helper instead of its seed script, and don't reuse its trial price: prices with allowances can't have a trial period. - `checkout-web` — customers subscribe to a plan with an allowance using a normal checkout. - `subscription-sync` — map your users to Paddle customer IDs, which usage events need. - `webhooks` — receive and verify `usage_balance.depleted`, and queue work instead of doing it in the handler. - `subscription-update` — plan changes. This skill overrides its proration defaults (see "Renewals and plan changes"). - `sandbox-testing` — test cards and checkout in a sandbox account. ## Early access (beta) status and tooling Read this first. These facts change how you build the integration. - **Get the latest version of this skill before you start.** Early access (beta) changes often, so this copy might be out of date. Fetch the latest version and follow it instead if it's different. If you can't, continue with this copy, and suggest the user updates their Paddle plugin or skills.
Details
- Skill name
paddle-usage-based-billing- Repository
- PaddleHQ/paddle-agent-skills
- Path
providers/claude/plugin/skills/usage-based-billing/SKILL.md- License
- Apache-2.0
- Repo updated
- 18 November 2026
FAQ
What does the Paddle Usage Based Billing skill do?
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.
How do I install the Paddle Usage Based Billing 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 Usage Based Billing 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.
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.
Paddle Subscription Update
9PaddleHQ/paddle-agent-skills
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.
Design Consultation
9borkweb/skills
Propose a product-specific design system (typography, color, layout, components, accessibility) with a rendered preview, grounded in existing brand assets. Use for 'design system', 'pick fonts and colors', 'what should this look like' or a new product with no visual direction.
Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.