vercel-optimize

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

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/MohamadJoumaa/Direct --skill vercel-optimize-mohamadjoumaa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-optimize
Source: https://github.com/MohamadJoumaa/Direct/tree/main/.cursor/skills/vercel-optimize
Command: npx skills add https://github.com/MohamadJoumaa/Direct --skill vercel-optimize-mohamadjoumaa

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 data; this Skill grounds every optimization recommendation in real Vercel observability metrics, billing usage, and verified code evidence instead of guesswork. ## Core Features & Use Cases - Metric-first auditing: Collects route-level function invocations, duration, cache hit rates, Core Web Vitals, and billing usage via the Vercel CLI before reading any source files. - Deterministic gating and verification: Pure-JavaScript threshold gates decide which candidates deserve investigation, and a verifier checks files, citations, and framework-version fit before anything reaches the report. - Ranked report with citations: Produces a Markdown report and concise chat summary with before/after code, allow-listed version-aware documentation citations, and cost impact framed as magnitude rather than invented dollar figures. - Use Case: A team with a rising Vercel bill runs the audit on their Next.js app; the skill flags an uncached high-traffic route and an over-broad middleware matcher, then delivers verified 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 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 grounded in observed data.

What frameworks does Vercel Optimize support?

Next.js App Router and Pages Router have the strongest support, SvelteKit and Nuxt are supported with route mapping, and Astro is limited to generic checks. Hono, Remix, and unknown frameworks pause up front and require opting into a limited platform-only audit.

Does Vercel Optimize 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 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 I trust the cost savings numbers in the report?

The skill deliberately avoids exact dollar projections and frames cost impact as order-of-magnitude only. Every recommendation must trace to observed metrics, verified files, and an allow-listed citation, and unverifiable claims are withheld from the report.