vercel-deployment

Vercel deployment workflows, environment management, domain configuration, and build troubleshooting. Use when deploying, checking deployment status, reviewing build logs, or managing environments.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

75%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 well-structured, actionable skill body that leverages tables and concrete MCP payloads efficiently, with a solid troubleshooting feedback loop. Main issues are a malformed nested numbered list and a few tools lacking example payloads.

Suggestions

Fix the malformed numbering in Build Troubleshooting: steps 3 and 4 are indented as children of step 2 instead of being top-level sequence items.

Add brief example MCP payloads for the remaining high-value tools (e.g., get_deployment, list_deployments) to round out actionability.

Tighten the Environment Variables best-practice line into an explicit validation checkpoint (e.g., "Before deploying, verify required env vars exist in production and preview scopes").

Dimension	Reasoning	Score
Conciseness	Mostly efficient tables and domain-specific guidance (branch→environment mapping, env scopes) that Claude would not already know, with only minor instances that could be tightened.	4 / 5
Actionability	Provides a concrete MCP tool table and copy-paste-ready JSON payloads for build logs, runtime logs, and re-deploy, with minor gaps for the remaining tools.	4 / 5
Workflow Clarity	The build troubleshooting section gives a clear numbered sequence with a "Repeat until build succeeds" feedback loop, though the nested list numbering is malformed and some validation is a passive checklist rather than an explicit checkpoint.	4 / 5
Progressive Disclosure	Well-organized into clear sections with a single one-level-deep external reference (deployment-config.md) that is clearly signaled; no bundle files exist to verify further.	4 / 5
	Total	16 / 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: specific, third-person, with an explicit "Use when..." trigger clause covering natural terms and a clearly distinct Vercel niche. Minor room to add synonyms or file/extension triggers.

Dimension	Reasoning	Score
Specificity	Lists several concrete workflow areas — "Vercel deployment workflows, environment management, domain configuration, and build troubleshooting" — which name specific actions rather than vague language, with minor coverage gaps.	4 / 5
Completeness	Explicitly answers both what (deployment workflows, environment management, domain configuration, build troubleshooting) and when (concrete trigger phrases in the "Use when..." clause), in third person.	5 / 5
Trigger Term Quality	The "Use when deploying, checking deployment status, reviewing build logs, or managing environments" clause offers good natural keyword coverage, though a few synonyms a user might say are missing.	4 / 5
Distinctiveness Conflict Risk	"Vercel deployment" is a clear niche with distinct, Vercel-specific triggers and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 suspicious	Warning

	Total	15 / 16 Passed

Repository: monkilabs/opencastle
Path: src/orchestrator/plugins/vercel/SKILL.md
Commit: fa0c341

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.