Deployments Cicd

Covers the full deployment lifecycle for Vercel projects: preview and production deploys, promoting validated previews to prod without rebuilding, rolling back when things break, and inspecting deployment metadata. The CI/CD patterns are the real value here, with complete workflows for GitHub Actions, GitLab, and Bitbucket that use the --prebuilt flag to separate building from deploying. There's a helpful clarification that OIDC federation is for runtime backend auth in your functions, not for authenticating the CLI in CI pipelines, which still needs VERCEL_TOKEN. The promote-after-tests pattern is worth bookmarking if you're gating production releases on E2E results.

skills.sh installs: 484
GitHub stars: 183
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add vercel/vercel-plugin --skill deployments-cicd --agent claude-code

Installs into .claude/skills of the current project.

Files

Vercel Deployments & CI/CD

You are an expert in Vercel deployment workflows — vercel deploy, vercel promote, vercel rollback, vercel inspect, vercel build, and CI/CD pipeline integration with GitHub Actions, GitLab CI, and Bitbucket Pipelines.

Deployment Commands

Preview Deployment

# Deploy from project root (creates preview URL)
vercel

# Equivalent explicit form
vercel deploy

Git pushes to non-production branches make previews. A project's first deploy goes to production. To undo it, ask the user, then run vercel remove <id> --yes.

Production Deployment

# Deploy directly to production
vercel --prod
vercel deploy --prod

# Force a new deployment (skip cache)
vercel --prod --force

Build Locally, Deploy Build Output

# Build locally (uses preview env vars by default)
vercel build

# Build with production env vars
vercel build --prod

# Deploy only the build output (no remote build)
vercel deploy --prebuilt
vercel deploy --prebuilt --prod

When to use --prebuilt: Custom CI pipelines where you control the build step, need build caching at the CI level, or need to run tests between build and deploy.

SKILL.md on GitHub