CtrlK
BlogDocsLog inGet started
Tessl Logo

vercel-deployment

Expert knowledge for deploying to Vercel with Next.js Use when: vercel, deploy, deployment, hosting, production.

48

Quality

52%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/vercel-deployment/SKILL.md

The canonical home for this skill is vercel-deployment in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

40%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 well-structured and lean at the section level but largely hollow: it describes categories of guidance without executable code, commands, or concrete config, and provides no deploy workflow with validation.

Suggestions

Add executable examples to each Pattern (e.g. a vercel.json snippet, an env-var configuration block, an edge-vs-serverless runtime export) instead of one-line descriptions.

Flesh out the Anti-Patterns and the Sharp Edges 'Solution' column with concrete fixes — currently they are headers and trailing colons with no content.

Provide a sequenced deployment workflow with validation checkpoints (build locally, verify env vars, deploy to preview, validate preview, promote to production).

DimensionReasoningScore

Conciseness

The body is short overall but spends tokens on persona fluff ('You are a Vercel deployment expert...') and a 'When to Use' list that duplicates the description's triggers; those sections could be trimmed.

3 / 5

Actionability

Pattern subsections are one-line abstractions ('Properly configure environment variables', 'Choose the right runtime'), the Anti-Patterns have no explanation beyond headers, and the Sharp Edges 'Solution' column ends in trailing colons with no actual solution, leaving only minimal high-level hints.

2 / 5

Workflow Clarity

There is no sequenced deployment workflow — only principles, patterns, and lists — and no validation checkpoints for a production-deploy process that is inherently risky, so it sits at a rough/incomplete sequence level.

2 / 5

Progressive Disclosure

Content is organized into clearly headed sections (Capabilities, Requirements, Patterns, Anti-Patterns, Sharp Edges) with no nested references; structure is clean, though the thin pattern/sharp-edge bodies could live in reference files with real detail.

4 / 5

Total

11

/

20

Passed

Description

65%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 has a clear niche and decent trigger terms with an explicit Use-when clause, but the capability statement is thin and relies on 'Expert knowledge' fluff rather than concrete actions.

Suggestions

Replace 'Expert knowledge for deploying' with concrete actions, e.g. 'Configure environment variables, choose edge vs serverless runtimes, optimize builds, and manage preview/production deployments on Vercel for Next.js.'

Add a couple of natural synonyms to the triggers, such as 'ship to vercel' or 'next.js deploy', to broaden match coverage.

DimensionReasoningScore

Specificity

The phrase 'Expert knowledge for deploying to Vercel with Next.js' names the domain clearly but offers only one minimal, generic action ('deploying'); it does not enumerate concrete deployment actions like configuring env vars, choosing runtimes, or setting up previews.

2 / 5

Completeness

It includes an explicit 'Use when:' clause (the 'when') and a stated purpose ('deploying to Vercel with Next.js' as the 'what'); the 'what' is somewhat vague ('Expert knowledge') which keeps it just below a 5.

4 / 5

Trigger Term Quality

'Use when: vercel, deploy, deployment, hosting, production.' provides good natural keyword coverage that users would commonly say, though it misses a few synonyms/extensions such as 'ship to vercel' or 'next.js deploy'.

4 / 5

Distinctiveness Conflict Risk

The Vercel + Next.js pairing carves a fairly clear niche, but generic triggers like 'deploy', 'hosting', and 'production' create minor overlap risk with other hosting/deployment skills.

4 / 5

Total

14

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-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.