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, fall back to a Node SDK seed script, or dictate dashboard steps as a last resort.

62

Quality

78%

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/catalog-setup/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is highly actionable with executable examples for every method, explicit validation and fallback loops, and rich domain-specific pitfalls. Its only notable weakness is moderate duplication between the modeling section and the pitfalls section that could be tightened.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious specifics (zero-decimal currencies, MCP snake_case/camelCase split, execute caps) and avoids explaining concepts Claude already knows, but repeats material: currency units appear in both 'What you're modeling' and 'Common pitfalls', and MCP casing conventions appear in both the Method 1 blockquote and 'Common pitfalls'. Not 4 because the duplication goes beyond minor trimmable instances.

3 / 5

Actionability

Fully executable, copy-paste-ready code for both the MCP path and the Node SDK path, exact run commands ('npx tsx scripts/seed-paddle-catalog.ts'), concrete dashboard click-paths, and specific error names ('400 bad_request', 'forbidden', 'product_tax_category_not_approved') each paired with recovery steps. Coverage spans the common cases: recurring, one-time, trial, and regional-override prices.

5 / 5

Workflow Clarity

Clear ranked method selection with explicit fallback rules ('If a method fails midway... fall back to the next method rather than retrying'), numbered sequences per method, error-driven feedback loops (permission regeneration, SDK fallback), and a dedicated Verify section with validation before completion. Checkpoints are explicit throughout this batch-creation workflow.

5 / 5

Progressive Disclosure

Well-organized single-file structure with clear sections (modeling decisions, method choice, three methods, verify, pitfalls, related docs) and clearly signaled external doc links; no bundle files exist. Not 5 because the dense MCP protocol blockquote and the tax-category table are inlined in a ~270-line file where a reference file could reduce load, though their placement near point-of-use is defensible.

4 / 5

Total

17

/

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.

The description is concrete and distinct, clearly stating what the skill does and the three methods it employs. Its main weakness is the missing explicit 'Use when...' trigger clause, leaving the invocation conditions only weakly implied.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user is starting a Paddle integration and the account has no products/prices yet, or asks to create or add Paddle products, prices, or plans.'

Include common user synonyms such as 'catalog', 'subscriptions', or 'billing plans' alongside 'products and prices' to broaden natural trigger coverage.

Consider naming the environment scope (sandbox vs live) to further distinguish from sibling Paddle skills.

DimensionReasoningScore

Specificity

Names the domain ('Create the Paddle products and prices') and several concrete actions ('try MCP tools first, fall back to a Node SDK seed script, or dictate dashboard steps'). Not 5 because coverage is method-focused and omits capability-level actions like trials, regional pricing, or tax-category selection.

4 / 5

Completeness

The 'what' is explicit (create Paddle products and prices via three ranked methods), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by 'that other Paddle skills depend on', which caps completeness at 3. Not 4 because trigger guidance is absent entirely rather than merely underspecific.

3 / 5

Trigger Term Quality

Good natural keywords a user would say: 'Paddle', 'products', 'prices', 'dashboard', 'Node SDK'. Not 5 because common synonyms like 'catalog', 'subscriptions', or 'billing plans' are missing.

4 / 5

Distinctiveness Conflict Risk

'Create the Paddle products and prices' carves a clear niche, but sibling Paddle skills (e.g. pricing-pages, checkout-web) share overlapping trigger vocabulary around 'Paddle' and 'prices', posing minor overlap risk with closely related skills. Not 5 for that family-level overlap; not 3 because the create-setup scope is well distinguished.

4 / 5

Total

15

/

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.