Vercel Optimize by Vercel Labs

Use Vercel Optimize by Vercel Labs to investigate cost and performance in a deployed Vercel project. Start with usage and production signals, identify routes or settings supported by evidence, and review prioritized recommendations tied to the project’s framework, source files, and available observability access.

Explain a change in Vercel usage

Bring a usage increase, slow route, or cache question with the measurements behind it. Ask for an evidence-based investigation connecting metrics to source and settings, with optimization choices that can be retested and still satisfy content-freshness requirements.

Include the period, affected functions or routes, and available cost or latency data.

Copy the request into a new Floatboat conversation and provide the required material.

Download Floatboat

Your request for Floatboat

Preview and copy the request. It is not sent automatically from this page.

Reference: Vercel Optimize
https://github.com/vercel-labs/agent-skills/blob/main/skills/vercel-optimize/SKILL.md

Read the original documentation and check the current environment and dependencies. Propose any new installation or tool connection before proceeding.

My task:
Investigate last month's Vercel function-cost increase. Confirm the project scope, use available metrics, and rank only evidence-backed opportunities.

Expected deliverable:
Evidence-backed opportunities ranked by likely impact, with a measurement plan for each.

About Vercel Optimize

Vercel Optimize is a Vercel Labs Skill for investigating deployed-project cost and performance using production evidence. Its bundled scripts collect signals and select candidates before the agent reads the related source files. This keeps recommendations tied to observed routes and settings rather than a broad search for suspicious code. The source describes framework-specific support for Next.js, SvelteKit, Nuxt, and limited Astro use. It requires a linked project, suitable CLI and Node versions, and the intended account scope; route-level metric-backed advice also needs Observability Plus. The workflow produces ranked recommendations, whose effects should be checked against the same workload after any implementation.

Use Cases for Vercel Optimize Skill

Usage increases, costly routes, and cache proposals need measured evidence before an optimization choice. Compare how Vercel Optimize links billing periods and route signals to source changes while retaining content-freshness and invalidation requirements.

Function usage rose unexpectedly

An unexpected rise in function usage needs a comparable billing period and route-level metrics before attributing cost to one endpoint or cache setting. Connect the observed usage to its source and rank optimization candidates by evidence. The explanation should distinguish measured contributors from plausible but untested causes.

One page seems expensive or slow

A page that seems slow or expensive should be investigated through its route signals, performance traces, and deployment versions. Let those measurements identify relevant source files and settings, then make a change that can be measured again. Preserve the path from metric to code so the optimization has a checkable basis.

A cache change is being proposed

A cache proposal must account for current hit patterns, framework behavior, and the content's freshness requirements. Compare ISR, middleware, or response-cache changes only after those conditions are understood. Explain invalidation risks and recheck both cache hits and content updates so lower usage does not hide stale results.

Establish a baseline for the next change

Before accepting a proposed optimization, agree on the route, time window, workload, and freshness conditions that will be compared. Retain the current measurements and link them to the relevant deployment. The later review can then judge whether cost or latency changed under comparable conditions, rather than attributing every movement in the dashboard to the most recent code edit.

How to Audit a Project with Vercel Optimize

Optimization begins with the measured usage or route behavior that needs an explanation. Follow the evidence into relevant source and settings, compare proposed changes with freshness constraints, and repeat the measurements before accepting a cost or latency improvement.

  1. Check scope and prerequisites

    Confirm the linked Vercel project, account, and framework. Check the source’s CLI, Node, and observability requirements before collecting signals.

  2. Collect and select evidence

    Use the bundled collection workflow to gather production signals. Let its gate identify candidates before investigating source files.

  3. Review ranked recommendations

    Inspect only the selected routes or settings with the agent. Review evidence, framework-version fit, and a validation plan for each proposed change.

Explore More Agent Skills

Read another Skill guide and check its original source before using it.

Vercel Optimize FAQ

Does Vercel Optimize scan the entire repository first?
No. Its documented doctrine collects production signals first and gates code investigation to metric-backed candidates.
Can it estimate savings without Observability Plus?
Route-level metric-backed recommendations require the stated observability access. Missing data should be reported as a limitation, not replaced with invented precision.
Which frameworks does it address?
The source lists strong support for Next.js, support for SvelteKit and Nuxt, limited Astro support, and a restricted path for others. Check the current source before running an audit.
Is it only a prose checklist?
No. The Skill bundles scripts and references for signal collection, gating, and report generation. Those still depend on authorized Vercel access.
What evidence is useful before starting an optimization review?
Provide the affected routes, a representative time window, and available latency, error, or resource signals. A concrete baseline makes recommendations more useful than a broad request to reduce every possible cost.
How should I validate a proposed optimization?
Compare the same workload before and after the change and check correctness as well as performance. A lower resource figure is not an improvement if errors increase or the user’s task stops working.
What prerequisites should I check before running Vercel Optimize?
The source lists Vercel CLI v53+, Node.js 20+, an authenticated CLI, and a linked project with the intended account scope. Route-level metric-backed recommendations require Observability Plus. Confirm the current source requirements before running its scripts.