skills.rest
incidentfox
incidentfoxOFFICIAL
Explore all skills by this author →
WebsiteGitHub

platform-vercel

Query Vercel projects, deployments, and build logs to investigate deployment failures.

656|82|Updated Jan 20, 2026
Search Tags:#api#vercel#Deployment#build logs#Debugging#ci cd#Incident Investigation
One-click install
npx skills add https://github.com/incidentfox/incidentfox --skill platform-vercel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: platform-vercel
Source: https://github.com/incidentfox/incidentfox/tree/main/sre-agent/.claude/skills/platform-vercel
Command: npx skills add https://github.com/incidentfox/incidentfox --skill platform-vercel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve?

Investigating Vercel deployment failures and build issues normally requires manually navigating the Vercel dashboard and digging through build logs. This Skill lets you query projects, deployments, and build events directly from your AI assistant to diagnose failures and regressions faster.

Core Features & Use Cases

  • Project & Deployment Queries: List Vercel projects, filter deployments by state (ERROR, READY, BUILDING) or target (production, preview), and inspect deployment details including git metadata.
  • Build Log Retrieval: Fetch deployment events and build logs to pinpoint where a build failed or stalled.
  • Deployment Creation: Trigger new preview or production deployments from a GitHub repo and branch.
  • Use Case: A production deploy just failed. Run list_deployments.py with --state ERROR, pull the build log with get_deployment_events.py, and correlate the failure with the commit SHA from the deployment metadata.

Quick Start

Ask the assistant to list recent failed deployments for your Vercel project and show the build logs for the most recent failure.

Frequently Asked Questions about platform-vercel

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

FAQPage Schema
How do I check why a Vercel deployment failed?▼

List failed deployments with list_deployments.py using --state ERROR, then run get_deployment.py to see errorCode and errorMessage fields. Finally, use get_deployment_events.py to read the full build log for detailed error output.

How to get Vercel build logs from the command line?▼

Run get_deployment_events.py with the deployment ID (dpl_...) to fetch build log events. Use --limit to control how many events are returned and --json for machine-readable output.

Do I need a VERCEL_TOKEN environment variable set?▼

No. Credentials are injected automatically by a proxy layer, so VERCEL_TOKEN will not be visible in the environment. Only VERCEL_TEAM_ID can optionally be set for team-scoped API requests.

Can I filter Vercel deployments by production or preview?▼

Yes. list_deployments.py accepts --target production or --target preview, and can be combined with --project and --state filters. This helps isolate production regressions from preview builds.

Can this skill create production deployments?▼

Yes, create_deployment.py supports --target production, but the skill instructs against creating production deployments without explicit user confirmation. The default target is preview for safety.

Related Skills

Explore More Software Engineering Skills→
openaiopenai
5.3k

sign-in-with-vercel

Implements OAuth 2.0 and OIDC user authentication using Vercel as the identity provider.

Official
Basic
ToanPV90ToanPV90

gha

Diagnose GitHub Actions workflow failures and identify breaking commits.

Community
Advanced
koralliskorallis
90

monitoring-observability

Implement monitoring, logging, metrics, and tracing with Grafana and Sentry.

Community
Intermediate
ComposioHQComposioHQ
223

Vercel CLI

Automate Vercel deployments, environment configuration, and log inspection via CLI.

Official
Intermediate