CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vercel-deployment

Deploy, configure, and manage web applications and serverless architectures on Vercel. Use when configuring vercel.json, managing environment variables, configuring custom domains, setting up edge/serverless functions, debugging builds, or automating deployments via Vercel CLI.

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

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 body is a strong operational runbook: highly executable commands and complete code examples organized into clear, ordered workflows with a verification section. Its main weaknesses are mild verbosity in the intro/links sections and detail (full config samples, CI workflow, function code) that is inlined where the progressive-disclosure pattern would move it into the already-present references directory, plus the absence of explicit error-recovery loops.

Suggestions

Move the complete vercel.json example, the full serverless/edge handler code, and the GitHub Actions workflow into files under references/ (alongside vercel-config-patterns.md), keeping only condensed snippets inline in SKILL.md.

Add an explicit feedback loop to the deployment workflows, e.g. 'if the deploy fails, run `vercel logs <url> --follow` to diagnose, fix, and redeploy' after the deploy steps.

Trim the introductory 'Comprehensive guide and operational runbook' sentence and consolidate the external-links section to the two most useful pointers.

DimensionReasoningScore

Conciseness

The body is largely command-and-code with minimal padding, but includes trimmable material: the 'Comprehensive guide and operational runbook' intro line, the external-links section (e.g. the Context7 line), and explanatory sentences like 'Triggers a preview deployment from the current working directory, generating a unique preview URL'. This fits the level-4 anchor 'efficient; minor instances of over-explanation that could be trimmed' — well above level 3's unnecessary explanations, but not the level-5 'every token earns its place'.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: exact CLI invocations with flags ('vercel link --project <project-name> --scope <team-slug> --yes', 'vercel deploy --prebuilt --prod'), a complete vercel.json, runnable TypeScript handlers, and a full GitHub Actions workflow covering the common cases. This matches the level-5 anchor; level 4 would imply minor gaps in the concrete examples, which are absent.

5 / 5

Workflow Clarity

Core workflows are clearly sequenced (link → env → config → deploy → functions → crons → CI/CD) with a dedicated Verification & Troubleshooting section ('vercel logs <deployment-url-or-id> --follow', 'curl -I ...') and a numbered prebuilt-deploy sequence. It falls short of level 5 because there are no explicit feedback loops for error recovery (e.g. what to do when a build fails or a deploy errors), but it is above level 3 since verification steps are explicitly present rather than missing.

4 / 5

Progressive Disclosure

Structure is good: a well-signaled, real one-level-deep reference ('Detailed architectural templates can be found in [vercel-config-patterns.md](./references/vercel-config-patterns.md)' — verified to exist) and organized sections. It does not reach level 5 because substantial detail (the full vercel.json example, complete function code, the full CI workflow) is inlined in SKILL.md rather than split into the existing reference structure, matching the level-4 anchor 'most content is appropriately placed; minor organization gaps'.

4 / 5

Total

17

/

20

Passed

Description

92%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 exemplary: it states concrete capabilities in third person and pairs them with an explicit, comma-separated 'Use when' trigger clause covering the main task surfaces (config, env vars, domains, functions, debugging, CI). The only gap is a handful of natural trigger synonyms (DNS, CI/CD, preview deployments, timeouts) that would push trigger term quality to full marks.

Suggestions

Add a few natural trigger synonyms to the 'Use when' clause, e.g. 'setting up DNS', 'managing CI/CD pipelines', 'resolving 504 timeout errors', or 'preview deployments', to broaden the natural-phrases users say.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Deploy, configure, and manage web applications and serverless architectures', 'configuring vercel.json, managing environment variables, configuring custom domains, setting up edge/serverless functions, debugging builds' — giving comprehensive coverage of the skill's capabilities, matching the level-5 anchor rather than level 4's 'minor gaps in coverage'.

5 / 5

Completeness

It explicitly answers both 'what' ('Deploy, configure, and manage web applications and serverless architectures on Vercel') and 'when' with an explicit 'Use when...' clause listing concrete triggers, matching the level-5 anchor exactly. Level 4 would require the 'when' to be less explicit, which is not the case here.

5 / 5

Trigger Term Quality

Strong natural keywords users would actually say ('vercel.json', 'environment variables', 'custom domains', 'edge/serverless functions', 'debugging builds', 'Vercel CLI'), but a few common variations are missing such as 'DNS', 'CI/CD', 'preview deployments', 'crons', or '504 timeout'. This fits the level-4 anchor 'good keyword coverage; a few natural terms missing' — not level 5, which requires synonym/extension-level comprehensiveness, and clearly above level 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (Vercel) with distinct triggers ('vercel.json', 'Vercel CLI', 'custom domains') that are unlikely to fire for other deployment or cloud skills, matching the level-5 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

19

/

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

administrakt0r/pro-skills-repo-administraktor

Path

skills/infrastructure-skills/vercel-deployment/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.