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".

2.23x

Quality

83%

Does it follow best practices?

Impact

96%

2.23x

Average score across 3 eval scenarios

Securityby

Critical

Do not install without reviewing

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured deployment skill with clear actionable commands and good workflow branching for different scenarios (CLI available, auth failure, network issues). The content is mostly concise but has minor verbosity in repeated timeout guidance and some explanatory text that Claude wouldn't need. Progressive disclosure is adequate given the skill's scope, though the referenced script bundle wasn't provided for verification.

Suggestions

Remove the redundant timeout mention in Prerequisites ('The deployment might take a few minutes. Use appropriate timeout values.') since it's already specified inline with the deploy command.

Tighten the fallback section by removing 'The script handles framework detection, packaging, and deployment.' — Claude doesn't need this explanation to use the script.

Dimension	Reasoning	Score
Conciseness	Mostly efficient but has some unnecessary explanation (e.g., 'The deployment might take a few minutes. Use appropriate timeout values.' followed by repeating the timeout advice inline). The 'Tell the user' guidance and some commentary could be tightened.	2 / 3
Actionability	Provides fully executable bash commands for each scenario (CLI check, deploy, fallback script, production deploy). Commands are copy-paste ready with specific flags (-y) and clear path placeholders.	3 / 3
Workflow Clarity	Clear sequential workflow: check CLI → deploy → fallback if needed. Includes explicit branching for auth failures, escalation guidance for network issues, and a troubleshooting section. The decision points (CLI installed vs not, auth error, network failure) are well-defined with specific recovery paths.	3 / 3
Progressive Disclosure	References scripts/deploy.sh appropriately, but no bundle files were provided to verify the reference. The content is reasonably structured with sections, but the troubleshooting section could reference an external file if more scenarios exist. The skill is self-contained enough that this is adequate but not exemplary.	2 / 3
	Total	10 / 12 Passed

Description

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid skill description with excellent trigger terms and completeness. The explicit 'Use when' clause with natural user phrases is a strong point. The main weakness is that the capability description could be more specific about what deployment actions are supported beyond the general 'deploy applications and websites'.

Suggestions

Add more specific concrete actions to the capability portion, e.g., 'Deploy applications and websites to Vercel, manage preview deployments, configure project settings, and check deployment status.'

Dimension	Reasoning	Score
Specificity	Names the domain (Vercel deployment) and the general action (deploy applications and websites), but doesn't list multiple specific concrete actions like configuring environment variables, managing domains, checking deployment status, or rolling back.	2 / 3
Completeness	Clearly answers both 'what' (deploy applications and websites to Vercel) and 'when' (explicit 'Use when' clause with specific trigger phrases like 'deploy my app', 'push this live', etc.).	3 / 3
Trigger Term Quality	Includes excellent natural trigger phrases users would actually say: 'deploy my app', 'deploy and give me the link', 'push this live', 'create a preview deployment'. These cover common variations of deployment requests.	3 / 3
Distinctiveness Conflict Risk	Clearly scoped to Vercel deployments specifically, with distinct triggers mentioning deployment actions. Unlikely to conflict with other skills unless there are multiple deployment platform skills, and even then 'Vercel' provides clear differentiation.	3 / 3
	Total	11 / 12 Passed

Validation

100%

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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: openai/skills
Commit: 972cb86

Reviewed: 2 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.