skills/vercel/SKILL.md
Deploy and manage applications on Vercel, including preview deployments and deployment protection. Use when working with Vercel-hosted projects or configuring Vercel deployments.
npx skillsauth add openhands/skills vercelInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Vercel deployments may have Deployment Protection enabled, which requires authentication to access preview deployments. This can block automated testing and agent access to preview URLs.
If you encounter a login page or authentication requirement when accessing a Vercel preview URL, the deployment has protection enabled. Signs include:
vercel.com/login or SSO login pageTo allow agents and automated systems to access protected deployments, users need to set up Protection Bypass for Automation:
Navigate to Project Settings
Generate a Protection Bypass Secret
Using the Bypass Secret
The secret can be used in two ways:
As a Header:
curl -H "x-vercel-protection-bypass: <secret>" https://your-preview-url.vercel.app
PowerShell equivalent:
Invoke-WebRequest -Headers @{ "x-vercel-protection-bypass" = "<secret>" } -Uri https://your-preview-url.vercel.app
As a Query Parameter:
https://your-preview-url.vercel.app?x-vercel-protection-bypass=<secret>
For Browser-Based Testing
?x-vercel-protection-bypass=<secret> to the preview URLIf protection bypass is not suitable, users can disable protection for preview deployments:
Do NOT repeatedly attempt to access protected URLs without the bypass secret. </IMPORTANT>
Set environment variables in Vercel Dashboard under Settings → Environment Variables, or use the Vercel CLI:
vercel env add MY_SECRET
Access in your application:
const secret = process.env.MY_SECRET;
Common Vercel CLI commands:
# Login to Vercel
vercel login
# Deploy to preview
vercel
# Deploy to production
vercel --prod
# List deployments
vercel ls
# View deployment logs
vercel logs <deployment-url>
# Pull environment variables locally
vercel env pull
tools
Iterate on a GitHub pull request — drive it through CI, code review, and QA until it is merge-ready. Poll verification layers with `gh` CLI, diagnose and fix CI failures, address review feedback, retry flaky checks, push fixes, and repeat. The agent is the orchestration loop.
development
Guides technical explanations toward flowing, direct, conversational prose. This skill should be used for engineering chat, design discussion, architecture analysis, code-review explanations, and technical recommendations that should be concise without becoming fragmented or vague.
tools
This skill should be used when the user asks to "set up a Jira automation to create pull requests", "poll Jira for create-pr issues", "automatically create GitHub PRs from Jira tickets", "deploy a Jira issue-to-PR automation", "create a Jira to GitHub PR workflow", or mentions automating GitHub PR creation from a Jira label. Deploys a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable label (default: "create-pr") and spawns an agent conversation to create a GitHub pull request for each new issue found. The target GitHub repository is read from the body of the Jira ticket - no repo parameter is required at deploy time.
tools
This skill should be used when the user asks to "create an automation", "schedule a task", "set up a cron job", "webhook integration", "event-triggered automation", or mentions automations, scheduled tasks, cron scheduling, or webhook events in OpenHands Cloud.