vercel-preview

Resolve the current git branch's Vercel preview deployment URL.

39|5|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill vercel-preview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-preview
Source: https://github.com/benjaminshoemaker/ai_coding_project_base/tree/main/.claude/skills/vercel-preview
Command: npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill vercel-preview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves the Vercel preview deployment URL for the current git branch, enabling tests against production-like environments instead of localhost.

Core Features & Use Cases

  • URL resolution: Retrieve the latest ready Vercel preview URL for the current branch.
  • Deployment verification: Check linked project status and wait for deployment readiness when required.
  • Integration: Works with browser verification and phase-checkpoint workflows; can be invoked directly to fetch or verify deployments.

Quick Start

Ensure Vercel CLI is installed and the project is linked; then invoke the skill in your project directory to obtain the preview URL for the current branch. If no preview is ready, use the optional wait behavior or fall back to local testing as configured.

Frequently Asked Questions about vercel-preview

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

FAQPage Schema
How do I get the Vercel preview URL for my current git branch?

You resolve the Vercel preview URL for your current git branch by invoking the skill in your project directory, which retrieves the latest ready deployment URL using the Vercel CLI and your linked project configuration.

What do I need to resolve a Vercel preview deployment URL?

You need the Vercel CLI installed and a linked Vercel project containing a .vercel/project.json file. Additionally, verification-config.json settings control deployment waiting behavior and timeout limits during URL resolution.

How does Vercel preview URL resolution handle deployments that are not ready yet?

When a Vercel preview deployment is not ready, the skill applies optional wait behavior governed by verification-config.json settings like waitForDeployment and deploymentTimeout. If waiting fails, it falls back to local testing as configured.

Can I use Vercel preview URL resolution for browser verification workflows?

Yes, Vercel preview URL resolution integrates directly with browser verification and phase-checkpoint workflows. It enables testing against production-like preview environments instead of relying on localhost during your verification flows.

Why is my Vercel preview deployment URL not resolving correctly?

Vercel preview URL resolution fails if the project is not properly linked via .vercel/project.json or the Vercel CLI is missing. Check your verification-config.json to ensure deployment is enabled and your tokenVar is correctly configured.