---
name: vercel-deploy-d80371885f78
description: Deploy projects to Vercel with one command. Use when user wants to deploy to Vercel, publish website, or needs production/preview deployment. Triggers on: "deploy to vercel", "vercel deploy", "发布到vercel", "部署到线上".
---

# Vercel Deploy Skill

Deploy current project to Vercel using Vercel CLI.

## Quick Start

1. Check if Vercel CLI is installed:
```bash
vercel --version
```

If not installed, prompt user to install:
```bash
npm i -g vercel
```

2. Check login status:
```bash
vercel whoami
```

If not logged in:
- Run `vercel login` - opens browser for OAuth login (no token needed)
- Or use VERCEL_TOKEN environment variable for CI/CD

3. Detect deployment mode:
- **Preview deployment** (default): `vercel`
- **Production deployment**: `vercel --prod`

## Deployment Workflow

### Step 1: Pre-deployment Check

1. Check project structure:
   - Look for `package.json`, `vercel.json`, `next.config.*`, `nuxt.config.*`
   - Detect framework automatically

2. Check for uncommitted changes:
   - Warn user about uncommitted changes
   - Suggest committing or using `--force`

### Step 2: Ask Deployment Mode

Prompt user to choose:
- **Preview** (default): For testing, creates preview URL
- **Production**: `vercel --prod`, creates production URL

### Step 3: Execute Deployment

Run the appropriate command:
```bash
# Preview deployment
vercel

# Production deployment
vercel --prod
```

### Step 4: Handle Result

1. **Success**: Display the deployment URL clearly
2. **Failure**: Parse error message, suggest fixes

## Common Issues

### Not logged in
```
Error: Not authenticated
```
Solution: Run `vercel login` - opens browser, click "Continue" to authenticate

### Project not linked
```
Error: No linked project
```
Solution: Run `vercel link` to link to a Vercel project

### Build failed
Check error output, common fixes:
- Check package.json scripts
- Verify build command in vercel.json
- Check environment variables

## Vercel Configuration

If user needs custom config, create `vercel.json`:

```json
{
  "buildCommand": "npm run build",
  "outputDirectory": "dist",
  "framework": "nextjs"
}
```

## Output Format

Present deployment result:

```
✓ Deployed! 🎉

Production URL: https://your-project.vercel.app
Preview URL: https://your-project-xxx.vercel.app

To deploy updates, run: vercel --prod
```

## Boundaries

- Focus on Vercel deployment workflow, project readiness, and rollout reporting.
- Do not broaden into generic cloud migration or platform-selection consulting unless the owner asks.
- Do not treat a successful CLI invocation as sufficient if the deployed app still lacks runtime validation.

## When NOT to Use

- Non-Vercel deployment targets (AWS/GCP/Azure/K8s) requiring broader infra work
- Application feature implementation/debugging not related to deployment
- Production rollouts without explicit owner approval and validation intent

## Escalation Rules

Pause and ask the owner before:

- deploying to production when preview validation has not happened
- changing environment variables, domains, or routing behavior with user-facing impact
- making assumptions about ownership of the target Vercel account or project

## Final Output Contract (MANDATORY)

Every use of this skill should end with:

1. `Skill Fit` - why Vercel deployment is the right path
2. `Primary Deliverable` - preview/production deployment result
3. `Execution Evidence` - commands run, URLs produced, and validation checks completed
4. `Risks / Open Questions` - config gaps, environment concerns, or rollout hazards
5. `Next Action` - the next validation or release step


---
Source attribution: JochenYang
Original project: https://github.com/JochenYang/Jochen-ai-rules/blob/2772c5d4dbab439e202337e58a419657209e16ae/skills/vercel-deploy/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 Jochen

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: JochenYang
Original project: https://github.com/JochenYang/Jochen-ai-rules/blob/2772c5d4dbab439e202337e58a419657209e16ae/skills/vercel-deploy/SKILL.md
Attribution basis: Source repository record

Fields of work: Development & Engineering, Product Management
Roles: Frontend Developer, Full-Stack Developer, Product Manager
Specialties: DevOps, Frontend, React, Testing
Tools: Vercel
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 902f444a45143032e9ed4253eafe0a22e38ed8e4c22b425ccb1bb289c6b0387a