Debugging Vercel Builds

Use this skill when a Vercel build or deployment fails. The goal is to identify the root cause before changing code or asking the user for secrets.

Step 1: Inspect the Build Error

Start with the Vercel build output:

• vercel-list-deployments to find the failed deployment ID, target, branch, and timestamp
• vercel-get-deployment-events with the deployment ID to read the build log
• Look for the first error, not the last — cascading failures start from one root cause

If the project ID is unknown, use vercel-list-projects first.

Step 2: Classify the Failure