| name | deploy |
| description | Deploy applications to Vercel. Use when deploying to preview or production. |
| allowed-tools | ["Bash"] |
| user_invocable | true |
Vercel Deploy
Deploy the current project to Vercel (preview or production).
Prerequisites
-
Check Vercel CLI is installed:
vercel --version
If missing: npm i -g vercel
-
Check project is linked:
ls .vercel/project.json 2>/dev/null || ls .vercel/repo.json 2>/dev/null || echo "NOT LINKED"
If not linked, run the setup skill first.
-
Check correct team:
vercel whoami
Deploy
Preview deployment (default)
vercel deploy
Production deployment
Production deploys overwrite what users see — confirm with the user before
running. In a monorepo, cd into the specific project directory first so the
right project is targeted.
vercel --prod
cd apps/web && vercel --prod
Deploy with prebuilt output
If vercel build was run first:
vercel deploy --prebuilt
Deploy with environment overrides
vercel deploy --env KEY=value
Post-Deploy
- Display the deployment URL from the command output.
- If errors occur, suggest checking logs with
/vercel:logs.
- For domain configuration, load
references/domains-and-dns.md.
Anti-Patterns
- Never use
vercel deploy after vercel build without --prebuilt — the build output is ignored.
- Never hardcode tokens in flags — use
VERCEL_TOKEN env var.
- Never use
--yes to skip Vercel confirmation prompts — let them run.
For full deployment reference, see references/deployment.md.