Vercel Deploy

1---
2name: vercel-deploy
3description: 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".
4---
5 
6# Vercel Deploy
7 
8Deploy any project to Vercel instantly. **Always deploy as preview** (not production) unless the user explicitly asks for production.
9 
10## Prerequisites
11 
12- Check whether the Vercel CLI is installed **without** escalated permissions (for example, `command -v vercel`).
13- Only escalate the actual deploy command if sandboxing blocks the deployment network calls (`sandbox_permissions=require_escalated`).
14- The deployment might take a few minutes. Use appropriate timeout values.
15 
16## Quick Start
17 
181. Check whether the Vercel CLI is installed (no escalation for this check):
19 
20```bash
21command -v vercel
22```
23 
242. If `vercel` is installed, run this (with a 10 minute timeout):
25```bash
26vercel deploy [path] -y
27```
28 
29**Important:** Use a 10 minute (600000ms) timeout for the deploy command since builds can take a while.
30 
313. If `vercel` is not installed, or if the CLI fails with "No existing credentials found", use the fallback method below.
32 
33## Fallback (No Auth)
34 
35If CLI fails with auth error, use the deploy script:
36 
37```bash
38skill_dir="<path-to-skill>"
39 
40# Deploy current directory
41bash "$skill_dir/scripts/deploy.sh"
42 
43# Deploy specific project
44bash "$skill_dir/scripts/deploy.sh" /path/to/project
45 
46# Deploy existing tarball
47bash "$skill_dir/scripts/deploy.sh" /path/to/project.tgz
48```
49 
50The script handles framework detection, packaging, and deployment. It waits for the build to complete and returns JSON with `previewUrl` and `claimUrl`.
51 
52**Tell the user:** "Your deployment is ready at [previewUrl]. Claim it at [claimUrl] to manage your deployment."
53 
54## Production Deploys
55 
56Only if user explicitly asks:
57```bash
58vercel deploy [path] --prod -y
59```
60 
61## Output
62 
63Show the user the deployment URL. For fallback deployments, also show the claim URL.
64 
65**Do not** curl or fetch the deployed URL to verify it works. Just return the link.
66 
67## Troubleshooting
68 
69### Escalated Network Access
70 
71If deployment fails due to network issues (timeouts, DNS errors, connection resets), rerun the actual deploy command with escalated permissions (use `sandbox_permissions=require_escalated`). Do not escalate the `command -v vercel` installation check. The deploy requires escalated network access when sandbox networking blocks outbound requests.
72 
73Example guidance to the user:
74 
75```
76The deploy needs escalated network access to deploy to Vercel. I can rerun the command with escalated permissions—want me to proceed?
77```
78