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

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

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 dense, highly actionable skill: complete executable examples, Paddle-specific gotchas Claude cannot know, explicit verification steps, and error-recovery guidance. The only weaknesses are mild redundancy (successUrl and throttling each covered twice) and a tangential MCP paragraph that could be trimmed or split out.

DimensionReasoningScore

Conciseness

Nearly every line is Paddle-specific knowledge Claude cannot know (frameTarget class rules, checkout.warning shape, absolute successUrl requirement, express variant constraints, updateItems replace semantics), with no explanation of concepts Claude already knows. Minor trimming opportunities: the MCP blockquote is a long tangential block, and the relative-successUrl and throttling guidance each appear twice (example notes plus pitfalls). Matches 4, not 5, which demands every token earn its place.

4 / 5

Actionability

Two complete, copy-paste-ready TSX examples (minimal overlay and full inline with event handling), exact npm install and env-var setup, concrete pre-fill and updateItems snippets, and a sandbox test card number. Fully executable guidance covering the common cases — matches the 5 anchor.

5 / 5

Workflow Clarity

Clear progression from prerequisites through style/variant selection to overlay-minimal then inline-full implementations, followed by pre-fill, dynamic items, events, and the webhook-vs-redirect decision. The numbered "Verify the integration" checklist provides explicit validation checkpoints and the "Common pitfalls" section gives error-recovery feedback (e.g. "Something went wrong message" → domain approval fix). Matches 5, not 4, since validation is explicit rather than implicit.

5 / 5

Progressive Disclosure

No bundle files exist, so scoring is on the SKILL.md's own structure: well-organized sections, compact decision tables, clearly signaled external links in "Related docs", and paired skills (webhooks, sandbox-testing) named for follow-on work. Minor gaps — the events table and the MCP block are candidates for separate reference files, keeping this at 4 rather than 5.

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 that clearly states what the skill does, but it omits any explicit "when to use" trigger clause, which caps completeness. Adding a trigger sentence with payment/billing synonyms would round it out.

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, overlay/inline checkout, or pre-filling customer details."

Include natural synonyms users might say without naming the product, such as "payment page", "billing", or "buy button", to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"Add a Paddle Checkout to a Next.js web app — overlay or inline, with event handling, customer pre-fill, and dynamic line item updates" lists multiple concrete actions (overlay/inline checkout, event handling, customer pre-fill, dynamic line item updates) with comprehensive coverage of the skill's stated scope.

5 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"Paddle Checkout", "Next.js", "overlay", "inline", and "checkout" are terms a user would naturally say, but common variations like "payment", "billing", or "subscribe" are missing. Good keyword coverage with a few natural terms absent — matches the 4 anchor, not the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Paddle Checkout" combined with "Next.js web app" carves out a clear niche with distinct triggers; minimal conflict risk with generic payment or web-development skills.

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

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.