vercel-optimize

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

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/arfaomar/NotebookLM-Clone --skill vercel-optimize-arfaomar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-optimize
Source: https://github.com/arfaomar/NotebookLM-Clone/tree/main/.agents/skills/vercel-optimize
Command: npx skills add https://github.com/arfaomar/NotebookLM-Clone --skill vercel-optimize-arfaomar

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 cost and latency signals live in observability dashboards while fixes live in source code. This Skill connects the two: it collects Vercel metrics, usage, and project config first, then investigates only the routes and files the metrics actually implicate, producing verified recommendations instead of guesswork. ## Core Features & Use Cases - Metric-first auditing: Collects route-level function invocations, duration, cold starts, cache hit rates, Core Web Vitals, ISR reads/writes, and billing usage via the Vercel CLI before reading any source files. - Deterministic gating: Pure-JavaScript threshold gates (no LLM judgment) 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 version-aware documentation library, and project config, then rendered into a ranked Markdown report with before/after code. - Use Case: A team notices their Vercel bill doubled. They run the audit from the linked project directory; the Skill finds an uncached high-traffic route and an over-aggressive ISR revalidate interval, then delivers cited, code-backed fixes. ## 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 your linked Vercel project directory and ask your agent to optimize the project. It collects usage and route metrics first, gates candidates with deterministic thresholds, and returns ranked recommendations with before/after code and documentation citations.

What frameworks does Vercel route-level optimization support?

Next.js App Router and Pages Router have the strongest route-to-file mapping, SvelteKit and Nuxt are supported, and Astro is limited to generic checks. Hono, Remix, and unknown frameworks are blocked by default unless you accept a limited platform-only audit.

Does the Vercel optimize audit work without Observability Plus?

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 or prove cost impact.

Why does the audit say my Vercel project is not linked?

The vercel metrics command requires directory linkage, so VERCEL_PROJECT_ID alone is not enough. Run vercel link --yes --project <project-name-or-id> --cwd <app-dir>, adding --team <team-slug> for team projects, then rerun the audit.

Can the skill predict exact dollar savings from a fix?

No. Cost impact is framed as order-of-magnitude language only, never exact dollar projections. Recommendations must trace to observed metrics, verified files, and allow-listed citations, and invented savings figures are stripped during verification.