vercel-optimize

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

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/agnivon/viral_thread_generator --skill vercel-optimize-agnivon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vercel-optimize
Source: https://github.com/agnivon/viral_thread_generator/tree/main/.agents/skills/vercel-optimize
Command: npx skills add https://github.com/agnivon/viral_thread_generator --skill vercel-optimize-agnivon

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 issues hide across functions, caching, middleware, and build pipelines. This Skill replaces guesswork with an observability-first audit that ties every recommendation to real production metrics. ## Core Features & Use Cases - Metric-Backed Audits: Collects Vercel metrics, usage, contract, and project config via the Vercel CLI before reading any source code, then applies deterministic gates to select investigation candidates. - Ranked Recommendations: Produces verified recommendations with before/after code, file and line references, and version-aware documentation citations from a curated allow-list. - Framework-Aware Analysis: Supports Next.js (App and Pages Router), SvelteKit, and Nuxt route-to-file mapping, with limited Astro support and explicit blocking for unsupported frameworks. - Use Case: A team sees a rising Vercel bill and slow page loads. They run the audit, which finds an uncached hot route, ISR over-revalidation, and a broad middleware matcher, then delivers a report with concrete fixes and citations. ## Quick Start From your linked Vercel project directory, ask your coding agent to optimize this Vercel project and reduce its cost and slow routes.

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 metrics first, applies deterministic gates to find cost drivers like uncached routes or ISR over-revalidation, then produces ranked recommendations with code fixes.

How does the Vercel optimization audit work?▼

The audit collects Vercel metrics, usage, and project config via the Vercel CLI, merges them with a codebase scan, and gates candidates with deterministic thresholds. Only metric-backed candidates are investigated, and every recommendation is verified against files and version-aware documentation citations.

Which frameworks does vercel-optimize support?▼

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

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

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

Why did the audit stop and ask about Observability Plus?▼

The skill pauses when route-level metrics are unavailable, such as when Observability Plus is disabled, the query quota is exhausted, or the project is not linked. It never silently falls back to code-only mode; you choose between enabling Observability Plus or accepting a limited audit.

Does the skill estimate exact dollar savings for recommendations?▼

No. Cost impact is framed using magnitude language rather than precise dollar projections. Recommendations are grounded in observed metrics and verified code evidence, but exact savings figures are deliberately avoided.