deployments-cicd

Guides Vercel deployments, promotions, rollbacks, and CI/CD pipeline configuration.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/AarnavBaddam/skills --skill deployments-cicd-aarnavbaddam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deployments-cicd
Source: https://github.com/AarnavBaddam/skills/tree/main/deployments-cicd
Command: npx skills add https://github.com/AarnavBaddam/skills --skill deployments-cicd-aarnavbaddam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deploying to Vercel through custom CI/CD pipelines involves many moving parts: choosing between preview and production deploys, deciding when to use --prebuilt, wiring up GitHub Actions or GitLab CI correctly, and handling promotions or rollbacks safely. This Skill provides expert guidance so you avoid misconfigured workflows, hanging pipelines, and failed builds. ## Core Features & Use Cases - Deployment Command Guidance: Covers vercel deploy, vercel --prod, vercel build, vercel deploy --prebuilt, vercel promote, vercel rollback, and vercel inspect with clear explanations of when to use each. - CI/CD Pipeline Templates: Ready-to-use workflow configurations for GitHub Actions, GitLab CI, and Bitbucket Pipelines, including required environment variables (VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID). - Advanced Patterns: Preview deployments on pull requests, promote-after-tests workflows, OIDC federation for runtime backend access, and a deployment strategy matrix for monorepos and atomic deploys. - Use Case: You want every pull request to produce a preview URL posted as a PR comment, then automatically promote to production after E2E tests pass on main. This Skill provides the exact GitHub Actions YAML and CLI commands to implement it. ## Quick Start Ask the assistant to generate a GitHub Actions workflow that builds and deploys your project to Vercel production using the prebuilt deployment pattern.

Frequently Asked Questions about deployments-cicd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy to Vercel from GitHub Actions?

Install the Vercel CLI in your workflow, then run vercel pull, vercel build --prod, and vercel deploy --prebuilt --prod, each with --token using your VERCEL_TOKEN secret. You also need VERCEL_ORG_ID and VERCEL_PROJECT_ID set as CI secrets.

What is the difference between vercel promote and vercel deploy --prod?

vercel promote instantly re-points the production alias to an existing preview deployment without rebuilding. vercel deploy --prod creates an entirely new deployment, which takes longer but produces a fresh build artifact.

When should I use vercel deploy --prebuilt?

Use --prebuilt in custom CI pipelines where you control the build step with vercel build, want CI-level build caching, or need to run tests between the build and deploy stages. It deploys only the build output without a remote build.

Does Vercel OIDC federation replace VERCEL_TOKEN in CI pipelines?

No. OIDC federation lets deployed Vercel functions authenticate to external services like AWS or GCP at runtime without static secrets. All CLI commands in CI such as vercel pull, build, and deploy still require --token with VERCEL_TOKEN.

Why does my Vercel build fail with ERR_PNPM_OUTDATED_LOCKFILE?

This error means your pnpm lockfile does not match package.json. Run pnpm install locally to regenerate the lockfile, commit it, and push again so the CI build uses consistent dependency versions.

How do I roll back a Vercel production deployment?

Run vercel rollback to revert to the previous production deployment, or vercel rollback <deployment-url-or-id> to target a specific deployment. This re-points the production alias without requiring a rebuild.