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

77%

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/cursor/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

77%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 highly actionable, well-sequenced integration guide whose code and pitfalls are excellent, and its verification checklist is a model feedback loop. The main drag is token weight: generic MCP/CLI tooling paragraphs inlined in a long single file add tokens without checkout-specific value.

Suggestions

Move the Paddle MCP and Paddle CLI blockquotes into a shared references/ file (e.g. references/paddle-tooling.md) and keep a one-line pointer in SKILL.md, cutting substantial tokens.

Trim the prerequisites prose (domain approval, payment link, token creation) to the essential decision + one fallback path, deferring dashboard-walkthrough detail to a reference.

Collect version-sensitive pins (@paddle/paddle-js 1.6.1/1.6.4/1.6.5, CLI v0.2.0) into a single version-requirements note so they age in one place.

DimensionReasoningScore

Conciseness

Mostly efficient — the code, event table, and pitfalls each carry non-obvious gotchas — but the two long blockquotes on the generic Paddle MCP tool contract and Paddle CLI usage are not checkout-specific and pad the skill, and time-sensitive version pins ('1.6.4+', '1.6.5+', 'v0.2.0 or later') are inline rather than in a deprecation/old-patterns section. Not 4 because the off-topic blockquote material is more than a minor trim.

3 / 5

Actionability

Two complete, copy-paste-ready TSX components (overlay minimal and full inline with eventCallback, throttled updateItems), exact npm install and env-var setup, concrete event-shape handling, and pitfalls with specific fixes. Specific examples cover the common cases.

5 / 5

Workflow Clarity

Clear sequence (prerequisites → style/variant choice → overlay → inline → pre-fill → dynamic items → events → redirect-vs-webhook → pitfalls) with an explicit verification checklist (dev run, sandbox test card, successUrl, checkout.completed, dashboard transaction) and error-recovery guidance in the pitfalls section.

5 / 5

Progressive Disclosure

Well-organized single file with clearly signaled cross-skill links and external docs, but no bundle files exist and the 326-line body inlines content that belongs in separate references — notably the generic Paddle MCP/CLI blockquotes, which are family-wide tooling rather than checkout instruction. Not 2 because the inline material is not a monolithic un-navigable blob and references are clearly signaled; not 4 because separable content is inlined with no one-level-deep reference structure.

3 / 5

Total

16

/

20

Passed

Description

66%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, action-oriented description in the correct third-person imperative voice, but it is missing the 'when' half entirely. Adding an explicit 'Use when...' clause with natural trigger phrases would lift both completeness and trigger-term coverage.

Suggestions

Append an explicit trigger clause, e.g. 'Use when adding Paddle checkout, payment, or billing flows to a Next.js app, or when the user mentions Paddle, Paddle.js, or a buy/checkout page.'

Include natural synonyms users say — 'payment', 'billing', 'buy button', 'Paddle.js' — to improve trigger term coverage.

Mention it is client-side only so it is distinguishable from the paired server-side Paddle skills (webhooks, subscription-sync).

DimensionReasoningScore

Specificity

Lists several concrete actions — 'overlay or inline', 'event handling', 'customer pre-fill', 'dynamic line item updates' — grounded in a named domain (Paddle Checkout in a Next.js web app). Not 5 because capabilities the skill covers (initialization, success-redirect handling, verification) are omitted; not 3 because it names well more than 1-2 specific actions.

4 / 5

Completeness

The 'what' is clear ('Add a Paddle Checkout... overlay or inline, with event handling, customer pre-fill, and dynamic line item updates'), but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'Next.js web app' only weakly implies when. Per the judging guidelines, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'Paddle Checkout', 'Next.js', 'overlay', 'inline', 'line item updates'. A few natural terms a user would say are missing — 'payment', 'billing', 'buy button', 'Paddle.js' — so it falls short of anchor 5's synonym/variation coverage.

4 / 5

Distinctiveness Conflict Risk

'Paddle Checkout' plus 'Next.js web app' carves a clear niche that would rarely trigger the wrong skill. Not 5 because closely related Paddle-family skills (webhooks, subscription-sync, catalog-setup) share the generic 'Paddle' trigger surface, leaving minor overlap risk on broad 'integrate Paddle payments' requests.

4 / 5

Total

15

/

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