vercel-agent — Codex skill: what it does, how to install
This skill explains Vercel Agent's PR reviews, incident investigations, and SDK setup. Use it when configuring or evaluating Vercel's development tools.
npx skills add openai/plugins --skill vercel-agent -a codexWhat vercel-agent does
The skill describes how Vercel Agent reviews PRs after a push or an @vercel mention in a PR comment. It checks for security vulnerabilities, logic errors, and performance issues, then suggests inline changes or a patch. Patch generation and validation run in Vercel Sandbox.
For anomaly investigations, Agent queries logs and metrics, looks for patterns across deployment data, and offers root-cause insights. This feature requires an Observability Plus subscription. SDK installation follows a separate flow: Agent inspects the repository, adds dependencies and integration code, then opens a PR for Web Analytics or Speed Insights. Installation is free. Code Review and Investigation cost $0.30 per run plus token costs; Pro teams have $100 in promotional credit.
Configure the service in the project's AI section in Vercel settings; no npm package is required. Install this skill to understand the service and its setup. It does not itself run Vercel Agent against your repository.
What it helps with
- review a PR for security and logic issues
- investigate an anomaly using logs and metrics
- add Web Analytics or Speed Insights through a PR
- find where to configure Vercel Agent
Example prompts for the agent
- Explain how Vercel Agent reviews a PR and proposes patches.
- How does Vercel Agent investigate an anomaly using logs and metrics?
- Describe how to add Web Analytics and configure Vercel Agent for this project.
How to install vercel-agent
1Skills CLI (Vercel)
npx skills add openai/plugins --skill vercel-agent -a codex2Manually: put the files in place
.agents/skills/vercel-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill vercel-agent -a claude-code2Manually: put the files in place
~/.claude/skills/vercel-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/vercel-agent/
Manually: put the files in place
.cursor/skills/vercel-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins vercel-agent2Manually: put the files in place
.github/skills/vercel-agent/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/vercel/skills/vercel-agentManually: put the files in place
.devin/skills/vercel-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set201
The whole set →Similar
Questions about vercel-agent
How do I install vercel-agent in Codex?
Run npx skills add openai/plugins --skill vercel-agent. To select Codex explicitly, run npx skills add openai/plugins --skill vercel-agent -a codex.
What does vercel-agent do?
The skill explains Vercel Agent's PR analysis, anomaly investigation, and setup of Web Analytics and Speed Insights. Vercel Agent itself is a service built into the Vercel platform.
Does anomaly investigation require a subscription?
Yes. Vercel Agent's investigation feature requires an Observability Plus subscription.
Source text
SKILL.md · Apache-2.0
---
name: vercel-agent
description: Vercel Agent guidance — AI-powered code review, incident investigation, and SDK installation. Automates PR analysis and anomaly debugging. Use when configuring or understanding Vercel's AI development tools.
metadata:
priority: 4
docs:
- "https://vercel.com/docs"
- "https://sdk.vercel.ai/docs"
sitemap: "https://vercel.com/sitemap/docs.xml"
pathPatterns:
- '.github/workflows/vercel*.yml'
- '.github/workflows/vercel*.yaml'
- '.github/workflows/deploy*.yml'
- '.github/workflows/deploy*.yaml'
- '.github/workflows/preview*.yml'
- '.github/workflows/preview*.yaml'
bashPatterns:
- '\bvercel\s+agent\b'
---
# Vercel Agent
You are an expert in Vercel Agent — AI-powered development tools built into the Vercel platform.
## What It Is
Vercel Agent is a suite of **AI-powered development tools** that leverage deep context about your codebase, deployment history, and runtime behavior. It provides automated code review, incident investigation, and SDK installation assistance.
## Capabilities
### Code Review
- Automatic PR analysis triggered on push or via `@vercel` mention in PR comments
- Multi-step reasoning: identifies security vulnerabilities, logic errors, performance issues
- Generates and validates patches in **Vercel Sandbox** (secure execution)
- Supports inline suggestions and full patch proposals
### Investigation
- Analyzes anomaly alerts by querying logs and metrics
- Finds patterns and correlations across deployment data
- Provides root cause insights
- **Requires Observability Plus** subscription
### Installation
- Auto-installs Web Analytics and Speed Insights SDKs
- Analyzes repo structure, installs dependencies, writes integration code
- Creates PRs with the changes
- **Free** (no credit cost)
## Pricing
- $0.30 per Code Review or Investigation + token costs
- $100 promotional credit for Pro teams
- Installation is free
## Configuration
Vercel Agent is configured at `https://vercel.com/{team}/{project}/settings` → **AI** section. No npm package required — it is a platform-level service.
## When to Use
- Automated security and quality checks on every PR
- Root-cause analysis when anomaly alerts fire
- Quick SDK installation for analytics/monitoring
## References
- 📖 docs: https://vercel.com/docs/agent
© Vercel Labs · Apache-2.0 · openai/plugins