CtrlK
BlogDocsLog inGet started
Tessl Logo

marketplace

Vercel Marketplace expert guidance — discovering, installing, and managing third-party integrations via the `vercel integration` CLI. Use when building any app that needs an external capability without a dedicated skill — commerce (stores, storefronts, selling products), payments (checkout, subscriptions, billing), observability/monitoring, messaging/email, search, or CMS — or when discovering, installing, or managing integrations.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 tightly engineered instruction skill: exact CLI commands with flags and aliases, a forced decision procedure, an explicit ordered sequence with stop-and-ask checkpoints and an error-recovery loop, and clean section structure with no bundle-file overhead. The only notable weakness is mild repetition and rhetorical padding around the install-first principle.

DimensionReasoningScore

Conciseness

The body is dense with instructions Claude does not already know (CLI commands, category slugs, provider-selection rules) and teaches no background concepts, matching 'efficient; minor instances of over-explanation that could be trimmed'. It is not a 5 because the install-before-build principle is stated three times (intro, MUST FOLLOW, the sequence header) and the intro's rhetorical emphasis ('throwaway work you will rip out') is padded relative to a lean directive.

4 / 5

Actionability

Guidance is fully executable: exact commands with flags ('vercel integration add <name> --no-claim', 'vercel env pull --yes', 'open <name>', 'resource claim', CI flags '--yes', '--format=json', '--no-claim'), documented aliases, and even a failure-recovery path (run the printed 'npx skills add …' command, never re-run add). Anchor 5 requires copy-paste-ready commands covering the common cases, which this meets; it is not a 4 because there are no pseudocode or missing-flag gaps.

5 / 5

Workflow Clarity

The sequence (categorize → discover → install → build) is explicit and ordered, with a decision checklist (MUST FOLLOW) and concrete checkpoints: 'If it needs the user's account or a dashboard/browser step → STOP and ask them to complete it, then continue', plus a feedback loop for the failed-skill-install case ('never re-run vercel integration add … have the user run only that'). This matches the 5 anchor (clear sequence, explicit validation/checkpoints, error-recovery loop, checklist); it is not a 4 because the stop-and-ask and recovery checkpoints are explicit rather than implied.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so this scores on structure alone: the body is compact (~75 lines), split into clearly headed sections (MUST FOLLOW, The sequence, Category map, Reference, Cross-References, Official Documentation), with external doc links clearly signaled and cross-references to sibling skills in a consistent '⤳ skill:' format. Nothing is inlined that belongs in a separate file — the 20-line category map is core decision material — and all referenced paths/links are real and one level deep.

5 / 5

Total

19

/

20

Passed

Description

87%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 description that pairs a concrete 'what' with an explicit, enumerated 'Use when' trigger clause and good synonym coverage of natural user needs. It sits just below the top anchor on specificity and trigger coverage because 'managing' is generic and a few common natural terms (provider names, cart, blog) are absent.

Suggestions

Name one or two flagship providers (e.g., Shopify, Stripe) in the description so users who mention a provider by name still hit this skill.

Add a couple of high-frequency natural trigger synonyms such as 'shopping cart', 'blog/CMS', or 'notifications' to close the remaining trigger-coverage gap.

Replace the generic 'managing' with a concrete action or two (e.g., 'listing, updating, and removing installed integrations').

DimensionReasoningScore

Specificity

Concrete actions are named in third person — 'discovering, installing, and managing third-party integrations via the `vercel integration` CLI' — plus an enumerated capability list (commerce, payments, observability/monitoring, messaging/email, search, CMS). It falls between anchors 4 and 5: several specific actions with the tool named, but 'managing' stays generic and coverage of the full CLI surface is not comprehensive.

4 / 5

Completeness

It explicitly answers both: the 'what' ('Vercel Marketplace expert guidance — discovering, installing, and managing third-party integrations via the `vercel integration` CLI') and the 'when' with a concrete 'Use when building any app that needs an external capability without a dedicated skill — commerce (...), payments (...), observability/monitoring, messaging/email, search, or CMS — or when discovering, installing, or managing integrations.' This mirrors the 5-anchor exemplar structure; it is not a 4 because the 'when' clause is explicit and enumerates concrete triggers rather than being loosely worded.

5 / 5

Trigger Term Quality

Natural user phrasings are present with synonyms — 'stores, storefronts, selling products', 'checkout, subscriptions, billing', 'messaging/email', 'CMS' — and the CLI name itself is a trigger. A few natural terms are missing (no provider names like Stripe/Shopify, no 'shopping cart', 'blog', 'forms'), so it matches 'good keyword coverage; a few natural terms missing' rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (Vercel Marketplace / third-party integrations) and explicitly disambiguates against sibling skills with 'without a dedicated skill', keeping storage/auth/AI out of scope. Trigger phrases (commerce via marketplace, vercel integration CLI) are distinct from generic tooling skills, so conflict risk is minimal.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
vercel/vercel-plugin
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.