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

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.

An excellent, highly executable skill body: complete code for all four methods, explicit verification with feedback loops, and deep coverage of Paddle-specific gotchas. The only real costs are length-driven — duplicated content between the modeling sections and 'Common pitfalls', and monolithic inlining of per-method detail that reference files could absorb.

DimensionReasoningScore

Conciseness

The body is dense with Paddle-specific knowledge Claude cannot know (camelCase method paths vs snake_case body params, zero-decimal currencies, exit codes 5/7, error shapes), so most tokens earn their place. Not 5 because the 'Common pitfalls' section restates material already covered earlier — currency units (lines 30/279), trials on one-time prices (25/281), case conventions (68/283), and environment separation (31/278) — which could be trimmed to cross-references.

4 / 5

Actionability

Every method ships copy-paste-ready, complete code: a full MCP `execute` async function with variants for one-time, paid-trial, and regional pricing; executable CLI commands with `--json` bodies and `--jq '.data.id'`; a complete Node SDK seed script including error handling and `npx tsx` run command; and click-by-click dashboard steps. Error recovery is concrete (exit code 5 → add `product.write`/`price.write`; `forbidden` → regenerate key).

5 / 5

Workflow Clarity

Clear ranked method selection with explicit fallback-on-failure rules, numbered steps per method, and a dedicated 'Verify' section that validates a batch create (list products with `include: ["prices"]`, confirm reported IDs match, suggest the next skill to confirm the catalog works). This matches the top anchor: explicit validation with feedback loops for a batch operation.

5 / 5

Progressive Disclosure

No bundle files exist, and the single SKILL.md is well-sectioned (modeling → method choice → four methods → verify → pitfalls → docs) with a decision overview up front. Not 5 because at ~290 lines the per-method deep-dives — especially the dense MCP and CLI blockquotes — are inline material that could be split into one-level-deep reference files.

4 / 5

Total

18

/

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-scoped description with a concrete fallback ladder, written in the correct voice. Its main weakness is the complete absence of a 'when to use this' clause, which both caps completeness and leaves the timing implicit.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user is starting a Paddle integration and the catalog doesn't exist yet, or asks to add new products or prices.'

Add natural synonyms users would say — 'Paddle catalog', 'billing', 'subscription plans', 'set up Paddle products' — to broaden trigger matching.

Briefly distinguish this skill from its siblings (e.g. mention 'checkout-web' comes after) so it doesn't compete with them for the same queries.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Create the Paddle products and prices', 'try MCP tools first', 'then the Paddle CLI', 'fall back to a Node SDK seed script', 'or dictate dashboard steps' — giving comprehensive coverage of the task and its full fallback ladder. It exceeds anchor 4 because nothing meaningful is left as a generic gap.

5 / 5

Completeness

The 'what' is clear and concrete (create products and prices, with an explicit four-method fallback ladder), but there is no 'Use when…' clause or equivalent explicit trigger guidance — 'that other Paddle skills depend on' only weakly implies timing. Per the judging guideline, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good keyword coverage ('Paddle', 'products', 'prices', 'MCP', 'CLI', 'Node SDK seed script', 'dashboard') that a user starting a Paddle integration would plausibly say. Not 5 because natural synonyms like 'catalog', 'billing', 'subscription plans', or 'set up' are missing.

4 / 5

Distinctiveness Conflict Risk

'Paddle' plus 'create products and prices' carves a clear niche that is unlikely to trigger for unrelated skills. Not 5 because the description references 'other Paddle skills' without any trigger distinguishing it from those closely related siblings (checkout, webhooks, pricing pages).

4 / 5

Total

16

/

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