vercel-optimize

Audits Vercel projects using observability metrics to produce ranked cost and performance recommendations.

1|Updated May 26, 2026
One-click install
npx skills add https://github.com/nimdvir/dima-publishing --skill vercel-optimize-nimdvir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vercel-optimize
Source: https://github.com/nimdvir/dima-publishing/tree/main/.agents/skills/vercel-optimize
Command: npx skills add https://github.com/nimdvir/dima-publishing --skill vercel-optimize-nimdvir

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Vercel bills and slow routes are hard to diagnose because teams guess at causes from source code instead of measured production signals. This Skill collects Vercel metrics, usage, and project configuration first, then investigates only the routes and files that deterministic gates flag, producing verified, citation-backed optimization recommendations. ## Core Features & Use Cases - Metric-First Auditing: Collects route-level function invocations, duration, cold starts, cache hit rates, Core Web Vitals, and billing usage through the Vercel CLI before reading any source files. - Deterministic Gating: Pure JavaScript threshold gates decide which candidates deserve investigation, with a default budget of 6 code-scope candidates and an interactive scope checkpoint. - Verified Recommendations: Every recommendation is checked against real files, an allow-listed documentation library, and detected framework versions before rendering a Markdown report. - Use Case: A team with a rising Vercel bill runs the audit on their Next.js app; the Skill identifies an uncached high-traffic route and an over-broad middleware matcher, then delivers before/after code fixes with official documentation citations. ## Quick Start From a linked Vercel project directory, ask your coding agent to optimize this Vercel project and reduce its bill.

Frequently Asked Questions about vercel-optimize

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

FAQPage Schema
How do I reduce my Vercel bill?▼

Run this audit from your linked Vercel project directory. It collects usage and route metrics, applies deterministic gates to find cost drivers like uncached routes, slow functions, and build fan-out, then produces ranked recommendations with verified code fixes.

How do I find slow or expensive routes on Vercel?▼

The Skill queries route-level function duration, invocations, cold starts, and cache hit rates through the Vercel CLI, then gates candidates by thresholds such as p95 over 500ms at meaningful traffic. Only metric-backed routes are investigated in source code.

Which frameworks does Vercel optimization support?▼

Next.js App and Pages Router and SvelteKit have full route-to-file mapping, Nuxt gets route mapping with generic checks, and Astro is limited. Hono, Remix, and unknown frameworks pause and require confirmation before a limited platform-only audit.

What are the requirements to run a Vercel metrics audit?▼

You need Node.js 20+, Vercel CLI v53 or later, an authenticated session, and a linked project directory via vercel link. Observability Plus is required for route-level metric-backed recommendations; without it the audit pauses or runs a limited code-only mode.

Why does the audit stop when route metrics are unavailable?▼

The Skill follows an observability-first doctrine, so it refuses to guess from source files when metrics fail. It reports the specific blocker, such as payment_required, not_linked, or no_traffic, and asks whether to enable Observability Plus or continue with a limited code-only audit.

Does the Vercel optimizer estimate exact dollar savings?▼

No. Recommendations use cost magnitude framing instead of precise dollar projections, and all citations come from a curated, version-aware documentation allow-list so invented URLs and mismatched framework advice are stripped.