CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paddle-onboarding

Check a Paddle account's onboarding status in sandbox or live — audit settings, credentials, notification destinations, catalog, domains, and verification, report what's done and missing against the go-live checklist, then fix the gaps the API allows with the user's approval.

Quality

84%

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-onboarding 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 exceptionally actionable, well-sequenced operational skill: every check and fix has exact API operations, permissions, error codes, and confirmation gates, with strong safety guardrails. The two structural weaknesses are inline reference-grade material (MCP/CLI conventions) that belongs in bundle files and notable repetition between Common pitfalls and earlier sections.

Suggestions

Move the MCP conventions and CLI conventions blockquotes into references/ files (e.g., references/mcp.md, references/cli.md) and load them only when that method is chosen, cutting SKILL.md's token footprint.

Trim 'Common pitfalls' entries that duplicate Step 3 table notes and 'Reading the results' (localhost, empty verifications list, domain-before-payment-link), keeping only pitfalls not already covered.

Consolidate the permission/forbidden guidance currently spread across 'Before you start', the method blockquotes, Step 3, and 'Permissions and forbidden' into the dedicated section.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious Paddle-specific facts (permission codes, error and exit codes, response shapes, verification statuses) and explains nothing Claude already knows, but the permission/forbidden story is repeated across four sections and 'Common pitfalls' re-states guidance already covered in Step 3 and 'Reading the results' (localhost, empty verifications list, domain-before-payment-link), so some trimming is possible. It is noticeably above the 'mostly efficient' midpoint despite this duplication, so 4 rather than 3.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: a complete MCP `execute` audit script, a CLI command block with a jq secret-scrubbing filter, a curl loop for direct API use, and exact PATCH bodies with permissions and expected error codes per fix. This matches the 'fully executable, covers common cases' anchor.

5 / 5

Workflow Clarity

A clearly sequenced four-step workflow (read-only audit → report → approved fixes with re-read verification → dashboard handoff) with explicit validation checkpoints: wrap each read so failures don't stop the audit, 'wait for a clear yes before writing', 're-read it and report the result', enumerated verification statuses with recovery guidance, and a retry-after-domain-approval feedback loop. Destructive/batch operations have guardrails and validation, so the workflow cap does not apply.

5 / 5

Progressive Disclosure

There are no bundle files and the entire ~300-line skill is one file, with reference-grade material — the MCP conventions blockquote (camelCase methods, pagination shape, execute caps) and the CLI conventions blockquote (exit codes, login handling) — inlined where separate references/ files would keep SKILL.md lean. Internal section structure is good, matching the 'some structure… content that should be separate is inline' anchor rather than the 4, whose example assumes bulk reference material lives in separate files.

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 specific, distinctive description that clearly states what the skill does across its full audit-report-fix range in third person. Its main weakness is the absence of explicit 'when to use' trigger guidance and of the natural user phrasings (e.g., 'is my account ready to go live?') that appear in the body but not the description.

Suggestions

Add an explicit trigger clause such as 'Use when the user asks whether their Paddle account is ready to go live, what's left to set up, or before switching an integration from sandbox to live.'

Include natural user phrasings like 'ready to take live payments', 'account setup', or 'switch from sandbox to live' to broaden trigger-term coverage.

State the environment scope ('in sandbox or live') as a trigger too, since users typically name the environment when asking.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'audit settings, credentials, notification destinations, catalog, domains, and verification', 'report what's done and missing against the go-live checklist', 'fix the gaps the API allows with the user's approval' — covering the skill's full capability range comprehensively, which matches the top anchor rather than the 'minor gaps' of a 4.

5 / 5

Completeness

The 'what' is clear and concrete (audit, report against the checklist, fix gaps), but there is no 'Use when…' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by 'go-live checklist' — which caps completeness at 3 per the judging guideline. It is not a 2 because the 'what' is explicit and multi-part, not vague.

3 / 5

Trigger Term Quality

It includes natural, domain-specific keywords users would say — 'onboarding status', 'go-live checklist', 'sandbox or live', 'Paddle account' — but misses common variations like 'ready to take live payments', 'account setup', or 'switch from sandbox to live', so it falls short of the comprehensive synonym coverage of a 5 while clearly exceeding the sparse keyword coverage of a 3.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — Paddle account onboarding/go-live readiness in sandbox or live — with terminology (go-live checklist, notification destinations, verification) that would not trigger other skills, matching the 'clear niche with distinct triggers' anchor.

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