CLOUD OPERATIONS / Vercel
Vercel Optimize
Runs a metrics-first Vercel audit: collects usage signals before reading source, gates candidates deterministically, then produces ranked cost and performance recommendations.
“Use for Vercel cost and performance optimization on deployed projects, especially Next.js, SvelteKit, Nuxt, and limited Astro apps.”
01 / THE REASONING
Why this made the selection.
- Enforces an observability-first pipeline: no source file is inspected until signals.json exists and a deterministic gate names a route, file, or setting, which blocks speculative rewrites.
- Ships a full audit toolkit at the pinned revision: doctrine plus candidates, data-collection, recommendations and scanner-patterns references with lib/ helpers for budget summary and cost coverage.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/vercel-optimize/SKILL.md
- skills/vercel-optimize/references/doctrine.md
- skills/vercel-optimize/references/data-collection.md
- README.md
- Repository git tree at 063bee94 (script count and licence-file check)
Our findings
- The pipeline refuses source inspection before metric collection and gates every candidate before deep-dives.
- References separate signal collection, candidate gating, and recommendation rendering with explicit verification and failure-copy sections.
- Prerequisites in the SKILL.md: Vercel CLI v53+ (vercel metrics, usage, contract and api), an authenticated vercel login session, a linked app directory, Node.js 20+, and Observability Plus for route-level recommendations.
- The gate step defaults to 6 code-scope candidates; --max-candidates 12 or all widens it. With three or more briefs the SKILL.md tells the host to spawn one sub-agent per brief.
- The SKILL.md forbids typing VERCEL_TOKEN=..., --token or Authorization: Bearer into commands that may be echoed in chat, and limits customer-facing cost claims to magnitude phrases, never a $ figure.
- Licence corrected 2026-10-13: this record earlier set redistribution to true on a README-only MIT declaration. No file named LICENSE or COPYING exists anywhere in the repository tree at 063bee94.
Not established by this review
- No Vercel project was audited and no usage API was called.
- Estimated savings and performance effects were not measured.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add vercel-labs/agent-skills --skill vercel-optimizeRun in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/vercel-labs/agent-skills/tree/063bee94c3f4df8453406c830b0a7df0f2860278/skills/vercel-optimize --skill vercel-optimize- Install the complete skill directory with its references, lib, and scripts; a copied SKILL.md alone is incomplete.
- Choose your AI tools and project or global scope in the installer, then review its permissions before using the skill.
Before you start
- Node.js/npm for this installer
- An agent that supports the Agent Skills format
- Access to the Vercel project, team, and usage metrics under review
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/skills/vercel-optimize/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access
https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/skills/vercel-optimize/references/doctrine.md
Supports: review, limitations
https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/skills/vercel-optimize/references/data-collection.md
Supports: review
https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/README.md
Supports: license
https://github.com/vercel-labs/agent-skills/blob/063bee94c3f4df8453406c830b0a7df0f2860278/README.md
Supports: install, compatibility
https://github.com/vercel-labs/skills/blob/48dc9e8eb8aa19040e91cb90ba0b642c9cbad57e/README.md
Supports: install
https://github.com/vercel-labs/skills/blob/48dc9e8eb8aa19040e91cb90ba0b642c9cbad57e/src/git.ts
Supports: install
https://github.com/vercel-labs/agent-skills/tree/063bee94c3f4df8453406c830b0a7df0f2860278
Supports: license, limitations, review