skills.rest
Adithiya-S
Adithiya-SCOMMUNITY
Explore all skills by this author →
GitHub

deployments-cicd

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

Updated Aug 21, 2025
Search Tags:#devops#deployment#rollback#github actions#vercel#ci cd#promote
One-click install
npx skills add https://github.com/Adithiya-S/AI-Study-Companion --skill deployments-cicd-adithiya-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deployments-cicd
Source: https://github.com/Adithiya-S/AI-Study-Companion/tree/main/.agents/skills/deployments-cicd
Command: npx skills add https://github.com/Adithiya-S/AI-Study-Companion --skill deployments-cicd-adithiya-s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deploying to Vercel through custom CI/CD pipelines involves many error-prone details: choosing between preview and production targets, deciding when to use --prebuilt builds, wiring up GitHub Actions, GitLab CI, or Bitbucket Pipelines correctly, and handling promotions or rollbacks safely. This Skill provides expert guidance so you configure and execute these workflows correctly the first time. ## Core Features & Use Cases - Deployment Command Guidance: Covers vercel deploy, --prod, --prebuilt, promote, rollback, inspect, and logs with correct flags for CI environments. - CI/CD Pipeline Templates: Ready-to-adapt workflow configurations for GitHub Actions, GitLab CI, and Bitbucket Pipelines, including PR preview deployments and promote-after-test patterns. - Troubleshooting & Best Practices: Common build error fixes, deployment strategy matrix, and structured deploy result reporting. - Use Case: You want every pull request to produce a preview URL posted as a PR comment, run E2E tests against it, and promote to production only after tests pass — this Skill walks you through the exact pipeline. ## Quick Start Ask the assistant to set up a GitHub Actions workflow that builds and deploys your project to Vercel production on every push to main.

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 a VERCEL_TOKEN secret. You also need VERCEL_ORG_ID and VERCEL_PROJECT_ID configured 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 validated preview deployment without rebuilding. vercel deploy --prod creates an entirely new production deployment, which takes longer but builds fresh from source.

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 local 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 without static secrets. CLI commands such as vercel pull, build, and deploy in CI still require --token with VERCEL_TOKEN.

How do I roll back a Vercel production deployment?▼

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

Why does my Vercel CI 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 so the CI build uses consistent dependency versions.

Related Skills

Explore More Software Engineering Skills→
akulkarniakulkarni
14

deploy-app

Automate Next.js application deployment to Vercel with authentication and environment variables.

Community
Intermediate
ByeongminLeeByeongminLee
2

observability

Instrument Next.js deployments with structured logging, traces, and analytics.

Community
Advanced
Prathmesh2000Prathmesh2000
1

ci-cd-pipeline

Automate CI/CD pipelines with linting, tests, security scans, and deployment gates.

Community
Advanced
brainbrewlabsbrainbrewlabs
7

doc-publishing

Publishes documentation to GitHub Pages, Vercel, or Netlify from source docs and build outputs.

Official
Intermediate