CtrlK
BlogDocsLog inGet started
Tessl Logo

vercel-deploy

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment". Do NOT use for deploying to Netlify, Cloudflare, or Render (use their respective skills).

69

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 action-dense, well-organized skill body: every command is executable, the fallback path is concretely specified, and detail is properly delegated to a real script. The only improvements are trimming the repeated timeout/escalation guidance and covering non-auth deploy failures in the primary path.

DimensionReasoningScore

Conciseness

The body is lean, assumes competence, and contains no concept explanations Claude already knows. Minor duplication keeps it below anchor 5: timeout guidance appears three times ('Use appropriate timeout values', 'with a 10 minute timeout', 'Use a 10 minute (600000ms) timeout') and escalated-network guidance appears in both Prerequisites and Troubleshooting.

4 / 5

Actionability

All guidance is copy-paste ready: 'vercel deploy [path] -y', 'vercel deploy [path] --prod -y', and 'bash scripts/deploy.sh' with three concrete invocation variants (current dir, project path, existing tarball), plus the exact message to relay to the user. This matches the anchor 5 'fully executable; copy-paste ready' example.

5 / 5

Workflow Clarity

The sequence is clear with strong error-recovery branches (auth error → fallback script; network error → escalated rerun with example prompt to the user), matching anchor 4. It falls short of 5 only because there is no checkpoint for a failed or partially failed build in the primary path — the skill says nothing about what to do if the deploy command itself errors other than the auth case, and success verification is explicitly skipped.

4 / 5

Progressive Disclosure

The body is a short, well-sectioned overview with a single one-level-deep, real bundle reference (scripts/deploy.sh, verified to exist) whose internals (framework detection, packaging, build waiting, JSON output) are correctly delegated rather than inlined. Section headers make navigation trivial, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Description

82%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 with explicit what/when structure, natural trigger phrases, and excellent negative-boundary disambiguation. The only gap is that it undersells the skill's concrete capabilities (preview vs. production deploys, the no-auth fallback path) behind a single generic 'deploy' verb.

Suggestions

Enumerate the skill's concrete capabilities in the description, e.g. 'Deploy applications and websites to Vercel as preview or production deployments, with a no-auth fallback script for packaging and deploying any project.'

Add a couple of missing natural trigger synonyms such as 'ship my app', 'go live', or 'publish' to the 'Use when...' clause.

DimensionReasoningScore

Specificity

The description names the domain ('Deploy applications and websites to Vercel') with a single concrete action — deploy. It does not enumerate the distinct capabilities the skill actually has (preview deploys, production deploys, no-auth fallback deployment), which the anchor for 4 ('lists several specific actions; minor gaps') would require; it is clearly above 2 ('names the domain but actions are minimal').

3 / 5

Completeness

It explicitly answers both what ('Deploy applications and websites to Vercel') and when ('Use when the user requests deployment actions like "deploy my app"...') with concrete trigger phrases, matching the anchor 5 example structure exactly. It also adds an explicit negative boundary ('Do NOT use for deploying to Netlify, Cloudflare, or Render').

5 / 5

Trigger Term Quality

Concrete natural phrases users would say are quoted directly: 'deploy my app', 'deploy and give me the link', 'push this live', 'create a preview deployment'. A few common synonyms are missing ('ship it', 'go live', 'publish', 'roll out'), which keeps it just below the comprehensive anchor 5 but comfortably above anchor 3.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (Vercel only) and explicitly disambiguates against the most confusable alternatives ('Do NOT use for deploying to Netlify, Cloudflare, or Render (use their respective skills)'), giving minimal conflict risk.

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
tech-leads-club/agent-skills
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.