CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paddle-catalog-setup

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.

Quality

83%

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

The canonical home for this skill is paddle-catalog-setup in PaddleHQ/paddle-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

An excellent operational skill: executable code for every method, explicit verification, and fallback-on-failure guidance, with almost no filler. The main structural weakness is that everything lives in one 23KB SKILL.md — the MCP/CLI convention blocks and tax table are reference-grade material that would fit (and be shared with sibling Paddle skills via) files under references/.

Suggestions

Move the MCP server conventions blockquote and the CLI conventions blockquote into a shared reference file (e.g. references/paddle-tooling.md) and keep a one-line summary in each method section, since sibling Paddle skills likely need the same conventions.

Consider offloading the tax-category table to references/tax-categories.md with just the saas/standard default guidance inline, reducing the main body's token footprint.

Trim the repeated end-of-method fallback sentences (each method already reiterates the ladder from 'Choose your method') and the 'product is what's sold / price is how it's charged' definitional aside.

DimensionReasoningScore

Conciseness

Nearly every line carries non-inferable Paddle specifics ('zero-decimal currencies — JPY, KRW, VND, CLP', 'Exit code 5 is a 403', 'Method paths are camelCase... body params are snake_case') rather than concepts Claude already knows. Minor trimmable spots remain — the 'A product is what's sold' conceptual aside and the fallback ladder being restated at the end of each method — so it fits 'efficient; minor instances of over-explanation' rather than the every-token-earns-its-place level of 5.

4 / 5

Actionability

All four methods ship copy-paste-ready, executable guidance: a complete MCP `execute` payload, CLI commands with full `--json` bodies and `--jq '.data.id'`, a full TypeScript seed script, and click-by-click dashboard steps. Common variants (one-time, paid trial, regional overrides) each get real code, matching the 'fully executable, covers the common cases' anchor.

5 / 5

Workflow Clarity

The sequence is explicit — confirm modeling choices with the user, pick the highest-ranked available method, execute, then a dedicated Verify section ('Confirm the products and prices exist', 'Confirm the IDs you reported match') — and failure feedback loops are built in ('If a method fails midway... fall back to the next method', exit-code-5 and `forbidden` remediation). Explicit validation plus error-recovery loops place it at the top anchor rather than 4.

5 / 5

Progressive Disclosure

The ~290-line body is well-sectioned but entirely self-contained: dense reference-grade material is inlined — the ~300-word MCP conventions blockquote, the CLI conventions blockquote, and the 9-row tax category table — with no bundle files or external references at all. This matches 'some structure but... content that should be separate is inline'; it does not reach 4 because substantial API-convention reference material that belongs in (likely sibling-shared) reference files is inlined.

3 / 5

Total

17

/

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 strong, concrete, third-person description that fully covers the 'what' and the method ladder with vendor-specific terms. Its one structural weakness is the absence of any explicit 'Use when...' trigger clause, which caps completeness and leaves the 'when' only implied.

Suggestions

Add an explicit trigger clause, e.g. 'Use when starting a Paddle integration and the catalog is empty, or when the user asks to create Paddle products, prices, or set up their Paddle catalog.'

Include natural synonyms users would say — 'catalog', 'subscription plans', 'billing setup' — to broaden trigger-term coverage beyond 'products and prices'.

DimensionReasoningScore

Specificity

The description states the core action ('Create the Paddle products and prices') and comprehensively enumerates a concrete four-method approach ('try MCP tools first, then the Paddle CLI, fall back to a Node SDK seed script, or dictate dashboard steps'). Coverage is complete for this skill's scope, matching the top anchor rather than the 'minor gaps' of 4.

5 / 5

Completeness

The 'what' is explicit ('Create the Paddle products and prices that other Paddle skills depend on') but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by the dependency framing. Per the rubric, a missing explicit trigger caps completeness at 3; it does not reach 4 because no 'when' is stated at all.

3 / 5

Trigger Term Quality

Natural keywords are present — 'Paddle', 'products', 'prices', 'MCP', 'CLI', 'dashboard' — which a user setting up a Paddle integration would plausibly say. Common synonyms such as 'catalog', 'subscription plans', or 'billing' are missing, so it fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Paddle catalog setup for sibling Paddle skills) with distinct, vendor-specific triggers, so it is unlikely to fire for the wrong skill. Even among closely related Paddle skills the dependency framing distinguishes it, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

PaddleHQ/paddle-agent-skills

Path

providers/cursor/plugin/skills/catalog-setup/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.