Vercel Deployment
Use this skill when
Use when checking Vercel deploy state, preview URLs, deployment logs, branch refs, env pulls, redeploys, alias cutover, or Vercel author/collaboration failures.
Workflow
- Identify the exact git branch and commit SHA being validated.
- Use Vercel CLI to inspect deployments by githubCommitRef or githubCommitSha.
- Wait for the deployment before pulling branch env or running smoke.
- Use deploy env parity checks before blessing staging or production.
- Record deployment URL/id, branch, commit, state, and smoke result.
Skill graph
Read references/graph.md for routing. Related skills: promote-deployment, db-health, neon-branch-management, environment-bootstrap, run-quality-gates, testing-infra.
Branch env wiring depends on what environment-bootstrap pulled into .env.local and what neon-branch-management knows about Neon branch routing — delegate when the failure is clearly an env-pull or Neon branch-mapping issue rather than a Vercel deploy issue.
References
- Vercel CLI docs: webfetch when command syntax or options are uncertain.
- references/workflow.md: workflow details and decision points.
- references/graph.md: related skills and handoff boundaries.
- references/original-guide.md: detailed operational reference.
Scripts
See scripts/README.md. Execute scripts for deterministic inspection or validation.
Assets
See assets/README.md for templates/checklists.