Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

vercel-optimize — Claude Code skill: Vercel cost audit

A skill that audits Vercel spend and speed: it gathers usage and route metrics first, then recommends code and config changes.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add vercel-labs/agent-skills --skill vercel-optimize -a claude-code
Open on GitHub

What vercel-optimize does

vercel-optimize audits from observability inward. scripts/collect-signals.mjs pulls metrics, usage and contract for the linked project on a shared 14-day window, scripts/scan-codebase.mjs reads the repo, scripts/merge-signals.mjs writes signals.json. Then scripts/gate-investigations.mjs picks the routes and files worth a look. Source files open only along the import chain of a candidate.

Reference files ship with it: references/docs-library.json for citations, references/voice.md for report wording. A citation that does not match your Vercel or framework version gets dropped.

Setup needs Vercel CLI v53+ with vercel metrics, vercel usage and vercel contract, a vercel login session, a directory linked by vercel link, and Node.js 20+. Route-level advice needs Observability Plus. Never paste auth tokens into shell commands.

Next.js is the strongest target, with route mapping and playbooks for App Router and Pages Router. SvelteKit and Nuxt are supported, Astro partly. Hono, Remix and unknown frameworks are blocked by default, so the skill stops and asks whether a limited audit is fine. Without Observability Plus you get no file-level route recommendations.

What it helps with

  • see what drives the Vercel bill from usage and contract data
  • find routes that cost the most in Function Invocations and Fast Data Transfer
  • check where caching takes load off functions
  • break down Build Minutes for the project
  • look at Core Web Vitals and bot traffic before touching code

Example prompts for the agent

  • Pull the Vercel metrics and show me why this project's bill went up.
  • Which routes are the most expensive, and what should I change in them?
  • Find caching candidates from Fast Data Transfer.

How to install vercel-optimize

1Skills CLI (Vercel)

npx skills add vercel-labs/agent-skills --skill vercel-optimize -a claude-code

2Manually: put the files in place

~/.claude/skills/vercel-optimize/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vercel-optimize/

From the same set6

The whole set →

Similar

caveman-manage JuliusBrussee The skill reads an experiment's state and results in Caveman Cloud, weighs the evidence, then reports one recommendation or blocks the action. Claude Code CX Codex Cursor +1 103,300installs migration JuliusBrussee Enforces reversible, compatibility-safe transitions for schema, data, and API updates. Useful whenever data loss or rollout downtime is unacceptable. Claude Code CX Codex Cursor +1 102,900installs git-workflow-and-versioning addyosmani A skill that sets git discipline for coding agents: atomic commits, short-lived branches, worktrees for parallel work. Useful when the agent commits faster than you review. Claude Code CX Codex Cursor +1 58,900installs shipping-and-launch addyosmani Walks your agent through a production launch: pre-launch checklist, monitoring, staged rollout and a rollback plan. Useful when a feature reaches real users. Claude Code CX Codex Cursor +1 57,800installs ci-cd-and-automation addyosmani Builds a GitHub Actions CI/CD pipeline for a repo: lint, type check, tests, build and dependency audit chained as gates on every pull request. Claude Code CX Codex Cursor +1 57,500installs wizard Matt Pocock This skill creates an interactive bash wizard for manual setup steps, CI secrets, third-party dashboards, and one-off migrations. Claude Code 553,369installs hyperframes-cli heygen-com Controls HyperFrames video workflows from the CLI: audits layouts and contrast, edits timeline clips, captures snapshots, and renders locally or in cloud runtimes. Claude Code CX Codex Cursor +1 1,200,000installs setup-pre-commit Matt Pocock This skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. Claude Code 489,289installs

Questions about vercel-optimize

How do I install vercel-optimize in Claude Code?

Run npx skills add vercel-labs/agent-skills --skill vercel-optimize -a claude-code. The skill file lands at ~/.claude/skills/vercel-optimize/SKILL.md.

What does vercel-optimize do?

It collects Vercel metrics and scans the codebase, gates what deserves investigation, then ranks recommendations tied to verified files and version-matched docs.

Which frameworks does it support?

Next.js App Router and Pages Router, SvelteKit and Nuxt; Astro only partly. On Hono, Remix or an unknown framework it stops and asks whether a limited audit is acceptable.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor