All skills
vercel-labs avatar

/deployments-cicd

@b06012d official

Vercel deployment and CI/CD expert guidance. Use when deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files for Vercel.

  • 5 files
  • 19.5 KB
  • Updated 14 hours ago
  • GitHub

Use this Skill: https://skilld.dev/gh/vercel-labs/vercel-plugin/deployments-cicd

This session only. Nothing lands on disk.

referencescli-pipelines.md

≈452 tokens on demand. Your agent reads this file only when SKILL.md points to it.

CLI Pipelines

These pipelines build and deploy with the Vercel CLI. Each needs the VERCEL_TOKEN, VERCEL_ORG_ID, and VERCEL_PROJECT_ID variables described in the skill's Required Environment Variables section.

Preview Deployments on PRs

The Git integration posts preview URLs on pull requests automatically. A CLI pipeline posts them itself:

# GitHub Actions
on:
  pull_request:
    types: [opened, synchronize]

env:
  VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}

jobs:
  preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g vercel
      - run: vercel pull --yes --environment=preview
      - run: vercel build
      - id: deploy
        run: echo "url=$(vercel deploy --prebuilt)" >> $GITHUB_OUTPUT
      - name: Comment PR
        uses: actions/github-script@v7
        with:
          script: |
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: `Preview: ${{ steps.deploy.outputs.url }}`
            })

GitLab CI

deploy:
  image: node:20
  stage: deploy
  script:
    - npm install -g vercel
    - vercel pull --yes --environment=production
    - vercel build --prod
    - vercel deploy --prebuilt --prod
  only:
    - main

Bitbucket Pipelines

pipelines:
  branches:
    main:
      - step:
          name: Deploy to Vercel
          image: node:20
          script:
            - npm install -g vercel
            - vercel pull --yes --environment=production
            - vercel build --prod
            - vercel deploy --prebuilt --prod

Source: SKILL.md on GitHub

No third-party reports yet.

Signed by skilld at b06012d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 10 hours ago.

Activeupdated 14 hours ago
Other metadata
metadata
{
  "priority": 6,
  "docs": [
    "https://vercel.com/docs/deployments",
    "https://vercel.com/docs/git",
    "https://vercel.com/docs/deployments/promoting-a-deployment",
    "https://vercel.com/docs/deployment-checks"
  ],
  "sitemap": "https://vercel.com/sitemap.xml",
  "pathPatterns": [
    ".github/workflows/*.yml",
    ".github/workflows/*.yaml",
    ".gitlab-ci.yml",
    "bitbucket-pipelines.yml",
    "vercel.json",
    "apps/*/vercel.json"
  ],
  "bashPatterns": [
    "\\bvercel\\s+deploy\\b",
    "\\bvercel\\s+--prod\\b",
    "\\bvercel\\s+promote\\b",
    "\\bvercel\\s+rollback\\b",
    "\\bvercel\\s+inspect\\b",
    "\\bvercel\\s+build\\b",
    "\\bvercel\\s+deploy\\s+--prebuilt\\b"
  ]
}
validate
[
  {
    "pattern": "cron:\\s*['\"]|from\\s+['\"](node-cron)['\"]|cron\\.schedule\\(",
    "message": "Manual cron scheduling detected. Use Vercel Cron Jobs (vercel.json crons) for platform-native scheduled tasks.",
    "severity": "recommended",
    "skipIfFileContains": "vercel\\.json.*crons|@vercel/cron"
  }
]
retrieval
{
  "aliases": [
    "deploy",
    "ci cd",
    "continuous deployment",
    "release pipeline"
  ],
  "intents": [
    "deploy to vercel",
    "set up ci cd",
    "promote deployment",
    "rollback deploy"
  ],
  "entities": [
    "vercel deploy",
    "preview",
    "production",
    "rollback",
    "promote",
    "CI workflow"
  ]
}

README badge

README badge for vercel-labs/vercel-plugin/deployments-cicd