vercel-optimize

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

Updated Aug 6, 2026
One-click install
npx skills add https://github.com/ferrarifankid04/ai-skills-public --skill vercel-optimize-ferrarifankid04
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-optimize
Source: https://github.com/ferrarifankid04/ai-skills-public/tree/main/claude-code/skills/vercel-optimize
Command: npx skills add https://github.com/ferrarifankid04/ai-skills-public --skill vercel-optimize-ferrarifankid04

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 without connecting production metrics to source code. This Skill runs an observability-first audit that collects Vercel metrics, usage, and project config before reading any source files, so every recommendation is grounded in real traffic data rather than guesswork. ## Core Features & Use Cases - Metric-backed investigation: Collects route-level function invocations, duration, cache hit rates, Core Web Vitals, and billing usage via the Vercel CLI, then applies deterministic gates to decide what deserves investigation. - Verified recommendations: Produces ranked recommendations with before/after code, file and line citations, and version-aware documentation links from a curated allow-list; unsafe or unverifiable suggestions are withheld. - Framework-aware analysis: Supports Next.js (App and Pages Router), SvelteKit, and Nuxt with route-to-file mapping, plus limited Astro support. - Use Case: Ask your agent to "optimize this Vercel project" from a linked project directory, and receive a Markdown report ranking issues like uncached hot routes, cold starts, ISR over-revalidation, and Build Minutes fan-out. ## 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 with this skill?

Run the audit from a linked Vercel project directory by asking your agent to optimize the project. It collects usage and metrics first, then produces ranked recommendations covering caching, function duration, Build Minutes, and bot traffic, each tied to observed data.

What are the requirements to run a Vercel optimization audit?

You need Node.js 20+, Vercel CLI v53 or later with an authenticated session, and a project directory linked via vercel link. Route-level metric analysis also requires Observability Plus enabled on the project.

Which frameworks does Vercel route-to-file optimization support?

Next.js App Router and Pages Router have the strongest support, followed by SvelteKit and Nuxt with route mapping. Astro has limited support, while Hono, Remix, and unknown frameworks are blocked unless you accept a limited platform-only audit.

What happens if Observability Plus is not enabled on my project?

The audit pauses and asks whether to enable Observability Plus or continue with a limited code-only audit. It never silently falls back, because scanner-only mode cannot rank hot routes or prove cost impact.

Why does the skill collect metrics before reading source files?

Metrics-first collection ensures recommendations trace to real production signals rather than repo-wide guesses. Deterministic gates then decide which candidates deserve investigation, and only files named by those candidates are read.

Does the skill estimate exact dollar savings for recommendations?

No. Cost impact is framed using magnitude language rather than precise dollar projections, and every recommendation must cite verified files and allow-listed documentation matching your framework version.