# vercel-deploy

> Automated Vercel deployment skill.

- Skill: `dokhacgiakhoa/vercel-deploy` (Agent Skill)
- Install (CLI): `npx skillmds add dokhacgiakhoa/vercel-deploy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dokhacgiakhoa/vercel-deploy/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: Dokhacgiakhoa (https://skillmd.com/u/dokhacgiakhoa)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/dokhacgiakhoa/vercel-deploy

---


# Vercel Deployment Skill

> **Goal**: Seamlessly deploy any frontend/full-stack application to Vercel global edge network.

## 1. Prerequisites

- **CLI**: `vercel` (Install via `npm i -g vercel`)
- **Auth**: User must be logged in (`vercel login`) or provide `VERCEL_TOKEN`.

## 2. Deployment Workflow

1.  **Detection**:
    - Scanner checks `package.json` for frameworks (Next.js, Vite, Remix, Astro).
    - Identifies build command (`npm run build`) and output directory (`dist` or `.next`).

2.  **Configuration**:
    - Generates `vercel.json` if custom headers/rewrites are needed.
    - Sets project settings (Root Directory, Framework Preset).

3.  **Execution**:
    - **Preview**: `vercel --no-prod` (For testing feature branches).
    - **Production**: `vercel --prod` (For live release).

4.  **Verification**:
    - Checks deployment status via `vercel inspect <url>`.
    - Returns the **Claimable URL** for the user.

## 3. Environment Variables

- **Auto-Sync**: Pulls `.env` from Vercel Project Settings (`vercel env pull`).
- **Push**: Pushes local `.env` to Vercel (Interactive confirmation required).

## 4. Troubleshooting common errors

- **Build Fail**: Usually due to strict type checking or linting in CI. Suggest `ignoreBuildErrors: true` ONLY for hotfixes.
- **Missing Secrets**: Check if `VERCEL_TOKEN` is active in CI/CD environment.

---

**Command Reference**:
- `vercel link`: Link local folder to remote project.
- `vercel deploy`: Deploy preview.
- `vercel deploy --prod`: Deploy production.