CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paddle-checkout-web

Add a Paddle Checkout to a Next.js web app — overlay or inline, with event handling, customer pre-fill, and dynamic line item updates.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./providers/claude/plugin/skills/checkout-web/SKILL.md

The canonical home for this skill is paddle-checkout-web in PaddleHQ/paddle-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, highly actionable integration guide with excellent verification steps and a well-chosen pitfall inventory. Its weaknesses are verbosity from generic Paddle MCP/CLI tooling material inlined in the skill, and no bundle structure to offload that reference content.

Suggestions

Move the Paddle MCP and CLI blockquotes into a shared reference file (or a family-level skill) and keep only a one-line pointer, cutting hundreds of tokens from the always-loaded body.

Define or stub the `PriceSection` component (or inline a minimal totals display) so the flagship inline example compiles as written.

Deduplicate the MCP checkoutUrl/checkoutDomains guidance, which appears in both Prerequisites and Common Pitfalls, into one troubleshooting entry.

DimensionReasoningScore

Conciseness

The core instructional sections (code examples, tables, pitfalls) are lean and earn their tokens, but the two long blockquotes on Paddle MCP tooling and the Paddle CLI, plus MCP method detail repeated in both Prerequisites and Common Pitfalls, are noticeably tangential to checkout and could be tightened or extracted. It is not a 4 because those padded passages are a substantial fraction of the document; it is well above 2 since most content is Paddle-specific knowledge Claude does not already have.

3 / 5

Actionability

The overlay example is complete and copy-paste ready, with concrete env vars, install commands, pre-fill and updateItems snippets, and a real sandbox test card. It is not a 5 because the main inline example references an undefined `PriceSection` component, so that example is not fully executable as written — a minor but real gap.

4 / 5

Workflow Clarity

The document sequences clearly from prerequisites through style/variant choice to a minimal overlay path, a full inline path, and an explicit "Verify the integration" checklist with expected outcomes per step. Common Pitfalls supplies error-recovery feedback loops (e.g. diagnosing "Something went wrong" via checkoutUrl/checkoutDomains checks); the operation is neither destructive nor batch, so no cap applies.

5 / 5

Progressive Disclosure

Section structure and external doc links are clear, but this is a ~320-line single-file skill with no bundle files, and content that belongs in a separate (or family-shared) reference — the generic MCP and CLI tooling blockquotes, and arguably the full event table — is inlined. It is above 2 because sections are well-organized and references are clearly signaled, but below 4 because of the inlined reference material in a long file.

3 / 5

Total

15

/

20

Passed

Description

71%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, well-targeted description with concrete capability language and strong product-level keywords. Its main weaknesses are the absence of an explicit 'Use when...' trigger clause and missing common payment/billing synonyms, which hold back completeness and trigger coverage.

Suggestions

Add an explicit trigger clause, e.g. "Use when adding a Paddle-hosted payment checkout to a Next.js app, whether overlay or inline."

Include natural synonyms users say, such as "payment", "billing", "subscribe", or "buy button", alongside "checkout".

Add a one-phrase scope note (e.g. "client-side only — pair with webhooks for provisioning") to reduce overlap with sibling Paddle skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete, domain-specific actions — "Add a Paddle Checkout", "overlay or inline", "event handling", "customer pre-fill", and "dynamic line item updates" — giving comprehensive coverage of the skill's capabilities. It clearly exceeds the 'several specific actions with minor gaps' anchor, matching the top anchor for concrete actions.

5 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance — only the weak implication that it applies when building a Next.js checkout. Per the rubric guideline, a missing explicit trigger clause caps completeness at 3; it is not a 2 because the 'what' is fully specified.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "Paddle Checkout", "Next.js web app", "overlay", "inline", "event handling", "customer pre-fill", "line item updates" are phrases users would plausibly say. It falls short of a 5 because common variations like "payment", "billing", "subscribe", or "subscription" are absent, so a user asking to 'set up payments' may not match it.

4 / 5

Distinctiveness Conflict Risk

"Paddle Checkout" plus "Next.js" is a clear niche that distinguishes it from sibling skills like webhooks or subscription-sync, so it is mostly distinct. It is not a 5 because the description gives no scoping statement (e.g., 'client-side only'), so a generic 'integrate Paddle' request has minor overlap risk with closely related skills in the same family.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

PaddleHQ/paddle-agent-skills

Path

providers/claude/plugin/skills/checkout-web/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.