# /deploy-to-vercel: Deploy a project to Vercel

Source: https://trendhub.net/skills/vercel-labs-agent-skills/deploy-to-vercel
Skill folder: https://github.com/vercel-labs/agent-skills/tree/main/skills/deploy-to-vercel
Pack: Vercel Agent Skills (https://trendhub.net/skills/vercel-labs-agent-skills)
Works with: Agent Skills-compatible agents

This skill lets an agent put a project live on Vercel by first checking whether the folder is linked, has a git remote and has a logged-in CLI. It then picks git push, a CLI deploy, or a temporary deployment with a claim link when no login is possible. Previews are the default; production needs an explicit request.

## When to use it

- You ask the agent to deploy an app and share the link
- You need a preview deployment of a branch
- The agent runs in a sandbox with no Vercel login

## How it works

1. **Inspect project state**: The agent checks for a git remote, a .vercel link file, CLI login and available teams.
2. **Pick a team**: If several teams exist, it asks which one to use and passes it as the scope on later commands.
3. **Choose a deploy method**: Linked projects with git are deployed by commit and push after you approve; others use vercel deploy or a link step first.
4. **Fall back without an account**: When login is not possible it runs a temporary deploy that returns a claim URL and an expiry time.
5. **Report the URL**: The agent shows the deployment URL and, for CLI deploys, checks build status with vercel inspect.

## What it steers the agent away from

- Pushing to git without asking first
- Deploying to production when only a preview was wanted
- Accidentally linking a folder by running interactive Vercel commands in an unlinked directory

## What it can touch

Runs shell commands: git (add, commit, push after approval), the Vercel CLI (whoami, teams, link, deploy, inspect, ls) and may install the CLI globally with npm. Uploads your project to Vercel over the network and can create a Vercel project.

## Pairs well with

- `/vercel-cli-with-tokens`
- `/vercel-optimize`
- `/react-best-practices`

## Questions

### Do I need a Vercel account?

Not for a first try. Without a login the skill makes a temporary deployment you can claim later; it does not work in CI or in a folder already linked to Vercel.

### Will it deploy to production?

Only if you explicitly ask. Otherwise it creates a preview deployment.
