Agent skill · practicalswan
vercel-optimize
Use for Vercel cost and performance optimization on deployed projects, especially Next.js, SvelteKit, Nuxt, and limited Astro apps. Collect Vercel metrics, usage, project config, and code scan results first; investigate only metric-backed candidates; produce ranked recommendations grounded in verified files and version-aware Vercel/framework docs. Trigger for Vercel bill reduction, slow or expensive routes, caching opportunities, Function Invocations, Build Minutes, Fast Data Transfer, Core Web Vitals, Bot Management, Fluid compute, or cost breakdown requests.
What it needs
About 10k tokens when loaded.
What this skill does
Vercel Optimize Run an observability-first Vercel optimization audit. Do not inspect source files until signals.json exists and a deterministic gate points to a route, file, or project setting. Core doctrine: read references/doctrine.md if any rule is unclear. Metrics first. Recommendations start from Vercel production signals, not repo-wide grep. Deterministic gates. scripts/gate-investigations.mjs decides what deserves investigation. Candidate-bound scope. Read only files named by a candidate or a route-local import chain. Version-aware citations. Use only references/docs-library.json; invalid or version-mismatched citations are stripped. Customer copy. Read references/voice.md before writing report text or chat output. Prerequisites Vercel CLI v53+ with vercel metrics, vercel usage, vercel contract, and vercel api. Authenticated CLI session: vercel login. Linked app directory: vercel link. VERCELPROJECTID can help resolve project config, but vercel metrics still requires directory linkage. The link or environment must include the intended project org/team/user scope so the collector can resolve a CLI-safe --scope and keep vercel metrics, vercel usage, and vercel contract on the same account. Node.js 20+. Observability Plus for route-level metric-backed recommendations. Never put auth tokens in shell commands. Do not type VERCELTOKEN=..., --token ..., or Authorization: Bearer ... into commands that may be echoed in chat. Framework Support The preflight reads package.json and sets expectations before metric fan-out. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills practicalswan/vercel-optimize