vercel-optimize

Audit Vercel projects for cost and performance issues using observability metrics and deterministic gates.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/AbuBakar125-co/Resturant_web --skill vercel-optimize-abubakar125-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-optimize
Source: https://github.com/AbuBakar125-co/Resturant_web/tree/main/agent/skills/vercel-optimize
Command: npx skills add https://github.com/AbuBakar125-co/Resturant_web --skill vercel-optimize-abubakar125-co

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 specific code. This Skill runs an observability-first audit that collects Vercel metrics, usage, and project config, then investigates only the routes and files that deterministic gates flag, producing ranked recommendations with verified citations. ## Core Features & Use Cases - Metric-backed investigation: Collects route-level function invocations, duration, cache hit rates, Core Web Vitals, ISR, and billing usage via the Vercel CLI before reading any source files. - Deterministic gating and verification: Pure-JavaScript threshold gates select candidates, and a verification step strips invalid citations, blocks contradictory recommendations, and withholds weak findings. - Use Case: Ask your coding agent to optimize a deployed Next.js app with a rising Vercel bill; the skill identifies uncached hot routes, cold-start-heavy functions, and ISR over-revalidation, then returns before/after code fixes with version-aware 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 with this skill?

Run the audit from a linked Vercel project directory and ask your agent to optimize the project. It collects usage and route metrics first, gates candidates deterministically, and returns ranked recommendations such as caching policies, ISR revalidation fixes, and Fluid Compute changes.

What 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 by default unless you accept a platform-only audit.

Does Vercel route-level metric analysis require Observability Plus?

Yes, route-level metric-backed recommendations require Observability Plus. Without it, the skill pauses and offers a choice: enable Observability Plus and rerun, or continue with a limited code-only audit that cannot rank hot routes.

Why does the audit stop with a project scope error?

The collector refuses to mix scopes when the linked project, team, or account cannot be resolved unambiguously. Relink with vercel link --yes --project <project> --team <team-slug>, or set both VERCEL_PROJECT_ID and VERCEL_ORG_ID for the intended account.

Can it run without reading my entire codebase?

Yes, that is the core design. Investigation is candidate-bound: only files named by a gated metric candidate or their route-local imports are read, and repo-wide grep is treated as a malformed candidate.