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.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

88%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, dense, highly actionable skill body: complete executable examples, non-obvious API gotchas, explicit verification steps, and a pitfalls section that doubles as error recovery. Its weaknesses are minor — some repetition between the explanation sections and pitfalls, a tangential MCP paragraph, and detail-heavy material kept inline rather than split into reference files.

Suggestions

State the relative-`successUrl` failure mode once (either in the inline walkthrough or in Common pitfalls) instead of twice, and trim the generic Paddle-MCP blockquote to the two or three lines relevant to provisioning a client token.

Move the full events table and the express variant rules into a `references/` file (e.g. events.md, variants.md) and link them from the body, keeping SKILL.md to the overlay and inline walkthroughs.

Keep the MCP workflow note but scope it to the one call used here (`client.clientTokens.create`) to cut the paragraph's length by roughly half.

DimensionReasoningScore

Conciseness

Nearly every token is Paddle-specific, non-obvious knowledge (camelCase MCP method paths vs. snake_case body params, "frameTarget is a CSS class name (no leading dot)", error events having "no `data`" with flat top-level fields). It falls short of the 5-anchor on minor redundancy: the relative-`successUrl` warning appears both in "Three things to notice" and again in "Common pitfalls", and the long Paddle-MCP blockquote is largely tangential to a client-side checkout skill. It stays above the 3-anchor because there is no generic-concept filler Claude already knows.

4 / 5

Actionability

Fully executable throughout: two complete copy-paste TSX components (overlay minimum and inline with events), exact install commands (`npm install @paddle/paddle-js`, `lodash.throttle` with types), environment variable snippets, precise dashboard navigation paths ("Paddle > My account > Settings > Authentication"), and a verification checklist with a concrete sandbox test card (`4242 4242 4242 4242`). This matches the 5-anchor; the minor gaps of the 4-anchor are absent.

5 / 5

Workflow Clarity

Clear progression from prerequisites through style choice, a minimal overlay path, the full inline pattern, advanced features, and pitfalls, ending with an explicit "Verify the integration" checklist (checkout renders, successUrl landing, dashboard transaction visible). The "Common pitfalls" section supplies error-recovery feedback for each failure signature. This fits the 5-anchor (explicit validation steps plus recovery guidance) better than the 4-anchor, whose checkpoints would be only mostly present.

5 / 5

Progressive Disclosure

Well-organized single-file structure with clear section headers, an informative events table, and well-signaled external links ("Related docs" pointing to specific Paddle developer pages). No bundle files exist, so all ~320 lines load at once; the events reference detail, the express variant rules, and the MCP usage blockquote are plausible candidates for separate reference files, which keeps it at the 4-anchor (good structure, minor organization gaps) rather than the 5-anchor. It is clearly above the 3-anchor because navigation is easy and nothing is buried or duplicative.

4 / 5

Total

18

/

20

Passed

Description

75%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, distinctive description with concrete capabilities on a clearly named platform. Its one material weakness is the absence of any "Use when..." trigger clause, which both caps completeness and leaves natural trigger phrases (payment, billing, purchase) underused.

Suggestions

Append an explicit trigger clause, e.g. "Use when adding Paddle payments or a hosted checkout to a Next.js app, or when the user mentions Paddle, payment overlay, or inline checkout."

Include common natural synonyms such as "payment", "billing", or "purchase" so users who say "add payments" without naming checkout find the skill.

Optionally note the boundary (client-side only; webhooks handled separately) in the description to reduce trigger overlap with a server-side webhooks skill.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "overlay or inline", "event handling", "customer pre-fill", and "dynamic line item updates" — on named platforms ("Paddle Checkout", "Next.js web app"), covering the skill's core scope comprehensively. The coverage matches the 5-anchor (multiple concrete actions, comprehensive) better than 4 because there are no meaningful gaps in the capability list.

5 / 5

Completeness

The "what" is clear ("Add a Paddle Checkout to a Next.js web app — 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, which caps completeness at 3 per the judging guidelines. It cannot score 4 because the "when" is entirely absent, not merely implicit.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "Paddle Checkout", "Next.js", "overlay", "inline", "customer pre-fill", "line item" are phrases users would actually say. It falls short of the 5-anchor because common natural synonyms like "payment", "billing", or "purchase" are missing, but it is clearly above the 3-anchor since coverage is good rather than partial.

4 / 5

Distinctiveness Conflict Risk

"Paddle Checkout" plus "Next.js web app" is a clear niche with distinct triggers; no other plausible skill competes for these terms. It fits the 5-anchor (clear niche, minimal conflict risk) rather than 4, since nothing in the description overlaps with adjacent skills like webhooks or subscription sync.

5 / 5

Total

17

/

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

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.