Paddle Subscription Sync
Mirror Paddle subscription and customer state into your database via webhooks — schema, upsert pattern, status semantics, scheduled changes, and access gating.
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-syncgit 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-sync ~/.claude/skills/paddle-subscription-syncPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Sync Paddle subscription state into your database ## When to use this skill Use this skill when you need a local copy of Paddle subscription and customer state — typically to gate features by subscription status, render account pages without round-tripping to the Paddle API, and report on revenue. This skill defines the table schema, the events to subscribe to, the upsert pattern, how to map your app's users to Paddle customers, status semantics, and how to handle scheduled changes (pauses, cancels effective at end of period). This skill assumes you already receive verified webhooks. If you don't, do `webhooks` first — that skill covers the route handler and signature verification. The code here lives inside the event handler functions that skill creates. ## Prerequisites - Working webhook endpoint with signature verification (`webhooks`). - A database (the examples use Supabase, but any SQL store with `UPSERT` works). - Subscribed events on your notification destination: - `customer.created`, `customer.updated` - `subscription.created`, `subscription.updated`, `subscription.canceled` - Optionally: `transaction.completed` (for one-off purchases), `subscription.activated` (when a trial converts) - For the backfill and reconciliation job: an API key with `customer.read` and `subscription.read`. The webhook handler itself doesn't call the API. ## Why mirror state at all?
Details
- Skill name
paddle-subscription-sync- Repository
- PaddleHQ/paddle-agent-skills
- Path
providers/claude/plugin/skills/subscription-sync/SKILL.md- License
- Apache-2.0
- Repo updated
- 18 November 2026
FAQ
What does the Paddle Subscription Sync skill do?
Mirror Paddle subscription and customer state into your database via webhooks — schema, upsert pattern, status semantics, scheduled changes, and access gating.
How do I install the Paddle Subscription Sync 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 Sync 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.
SQL Reviewer
9shisuidata/ss-data-skills
Use when reviewing SQL for data development. Checks logic correctness, metric consistency, joins, aggregations, deduplication, null handling, date boundaries, partition filters, performance risks, engine-specific issues, and safer rewrite suggestions. 中文触发词:SQL 审查、SQL Review、SQL 算错、慢 SQL。
Multi Tenant
9zllovesuki/cloudflare-agent-skills
Design multi-tenant Cloudflare applications with tenant isolation, D1 row/database boundaries, Durable Object-per-tenant patterns, R2 key prefixes, KV cache keys, authz, noisy-neighbor controls, and migration paths. Use for SaaS and platform code.
Flyway Migrations
5senoritadeveloper01/claude-skills
Use this skill when creating or reviewing Flyway database migrations in a Spring Boot project. Covers schema evolution, data migrations, zero-downtime strategies, and PostgreSQL best practices.
Browse the most popular Claude skills, all databases skills, or write your own with the skills generator.