vercel-optimize

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

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

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 data 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 - Metrics-first audit pipeline: Collects route-level function invocations, duration, cache hit rates, Core Web Vitals, ISR reads/writes, and billing usage via the Vercel CLI before reading any source files. - Deterministic gating and verification: Pure-JavaScript threshold gates decide what gets investigated, and every recommendation is verified against real files, line numbers, and an allow-listed, version-aware documentation library. - Ranked report with before/after code: Produces a Markdown report and concise chat summary with recommendations tied to observed metrics, plus held-back findings when evidence is insufficient. - Use Case: A Next.js app's Vercel bill doubled last month. Run the audit to discover that two high-traffic routes have a 10% cache hit rate and middleware fires on 80% of requests, then get specific caching and matcher fixes with 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 first, then ranks recommendations such as fixing low cache hit rates, narrowing middleware matchers, enabling Fluid Compute, or reducing ISR over-revalidation, each tied to observed data.

How to find slow or expensive routes on Vercel?

The skill queries route-level function duration, invocations, and cold starts through the Vercel CLI, then applies deterministic thresholds to flag hot routes. Only routes that pass these metric gates are investigated in source code.

Which frameworks does Vercel optimization support?

Metric-backed route-to-file recommendations are strongest for Next.js App and Pages Router and SvelteKit, supported with generic checks for Nuxt, and limited for Astro. Hono, Remix, and unknown frameworks pause by default unless you accept a limited platform-only audit.

What are the requirements to run a Vercel optimization audit?

You need Node.js 20+, Vercel CLI v53 or later, an authenticated CLI session, and a project directory linked with vercel link. Route-level metric analysis also requires Observability Plus; without it the skill pauses and offers a limited code-only audit.

Why does the audit stop when route metrics are unavailable?

The skill is observability-first: without route metrics it cannot rank hot routes or prove cost impact, so it pauses instead of guessing. You can enable Observability Plus and rerun, or explicitly accept a limited scanner-only audit.

Does the skill estimate exact dollar savings for recommendations?

No. Cost impact is framed as order-of-magnitude phrases rather than precise dollar figures, because exact savings cannot be verified from the available signals. Recommendations always cite observed metrics and allow-listed documentation instead.