deploy-to-vercel
Deploy applications and websites to Vercel with automatic git integration and preview URLs.
- Supports three deployment paths: git-push (ideal for linked projects), direct CLI deployment, and no-auth fallback for sandboxed environments
- Automatically detects project state (linked via
.vercel/project.jsonor.vercel/repo.json, git remote presence, CLI authentication) and chooses the best deployment method - Handles team selection for multi-team accounts and uses
--scopeto deploy to the correct team - Provides preview URLs for all deployments; linked projects with git remotes enable automatic deployments on future pushes
- Includes fallback scripts for claude.ai and Codex sandboxes that require no authentication, returning both preview and claim URLs
Deploy to Vercel
Deploy any project to Vercel. Always deploy as preview (not production) unless the user explicitly asks for production.
The goal is to get the user into the best long-term setup: their project linked to Vercel with git-push deploys. Every method below tries to move the user closer to that state.
Step 1: Gather Project State
Run all four checks before deciding which method to use:
# 1. Check for a git remote
git remote get-url origin 2>/dev/null
# 2. Check if locally linked to a Vercel project (either file means linked)
cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null
# 3. Check if the Vercel CLI is installed and authenticated
vercel whoami 2>/dev/null
More from vercel-labs/agent-skills
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
392.2Kweb-design-guidelines
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
313.5Kvercel-composition-patterns
React composition patterns that scale. Use when refactoring components with
170.2Kvercel-react-native-skills
React Native and Expo best practices for building performant mobile apps. Use
114.9Kvercel-react-view-transitions
Guide for implementing smooth, native-feeling animations using React's View Transition API (`<ViewTransition>` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter/exit of components, animate list reorder, implement directional (forward/back) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view transitions, `startViewTransition`, `ViewTransition`, transition types, or asks about animating between UI states in React without third-party animation libraries.
31.9Kvercel-cli-with-tokens
Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".
31.4K
More in Next.js
next-best-practices
File conventions, RSC boundaries, data patterns, async APIs, and metadata
vercel-labs/next-skillsnext-cache-components
PPR, use cache directive, cacheLife, cacheTag, and revalidateTag
vercel-labs/next-skillsturborepo
Turborepo task pipelines, caching, remote cache, and CI configuration
vercel/turborepoai-sdk
Vercel AI SDK: generateText, streamText, tool calling, and useChat
vercel/ai