Official agent skill

Custom Metrics

by vercel in vercel/vercel-plugin

Emit and query Vercel Custom Metrics. An agent skill from vercel/vercel-plugin.

OfficialCustom licenceAuto-check passed

Install Custom Metrics

skills CLI
$ npx skills add vercel/vercel-plugin --skill custom-metrics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vercel/vercel-plugin custom-metrics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vercel/vercel-plugin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/custom-metrics .claude/skills/custom-metrics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
custom-metrics
GitHub stars
301
Token cost
~1.6k tokens
SKILL.md length
509 words
Files
2
Skills in repo
38
Repo updated
First seen
Licence
Custom licence

At a glance

Emit and query Vercel Custom Metrics. An agent skill from vercel/vercel-plugin.

  • Works in 5 steps: Confirm the function was deployed to… → Confirm @vercel/functions exports… → Check vc whoami, the selected team, and… → …
  • Instrumenting application
  • SKILL.md covers Emit a metric, Model metrics for useful queries, Discover and query the metric and Use the right signal
  • Calls pnpm

What it does

Custom Metrics is an agent skill from vercel/vercel-plugin, published by the product's own GitHub organization. Emit and query Vercel Custom Metrics. Use when instrumenting application or business measurements in Vercel Functions, using metric() from @vercel/functions, choosing metric names and attributes, or querying emitted values with vc metrics.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It works with Vercel. The repository describes itself as: Comprehensive Vercel ecosystem plugin — relational knowledge graph, skills for every major product, specialized agents, and Vercel conventions. Turns any AI agent into a Vercel…

When your agent uses it

  • Instrumenting application
  • Business measurements in Vercel Functions
  • Using metric() from @vercel/functions
  • Choosing metric names and attributes

Example prompts

  • “/custom-metrics”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the function was deployed to Vercel and the instrumented path actually ran.
  2. Confirm @vercel/functions exports metric; upgrade it if necessary.
  3. Check vc whoami, the selected team, and the linked project.
  4. Allow for ingestion delay, then rerun vc metrics schema.
  5. Confirm Observability Plus and Custom Metrics are enabled for the team.

What it can do on your machine

Read from SKILL.md and the folder at commit 82fa491. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Custom Metrics loads about 1.6k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 509 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 509 words (~1,631 tokens).

“Use Custom Metrics for numeric application and business measurements emitted by server-side code running in a Vercel Function. The workflow is emit a numeric sample with metric() → invoke the deployed function → discover and query the metric with vc…”

— opening of SKILL.md by vercel, Custom licence
name
custom-metrics
summary
Emit numeric measurements from Functions and query them with vc metrics
metadata.priority
9
metadata.docs
https://vercel.com/docs/functions/functions-api-reference/vercel-functions-package, https://vercel.com/docs/cli/metrics…
metadata.sitemap
https://vercel.com/sitemap/docs.xml
metadata.bashPatterns
\b(?:vercel|vc)\s+metrics\s+(?!schema(?:\s|$)|vercel\.)[A-Za-z_][A-Za-z0-9_./-]*\b, \b(?:vercel|vc)\s+metrics\s+schema\s+(?!vercel\.)[A-Za-z_][A-Za-z0-9_./-]*\b
retrieval.aliases
Vercel application metrics, Vercel business metrics, function metrics, vc metrics
retrieval.intents
emit a custom metric, instrument a Vercel Function, query a custom metric, measure application behavior
retrieval.entities
metric, @vercel/functions, Vercel Custom Metrics, vc metrics, Observability Plus
retrieval.examples
emit checkout duration as a custom metric, add a business counter to this Vercel Function, query my custom metric with vc metrics, group an application metric…

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/custom-metrics of vercel/vercel-plugin.

  • SKILL.md
  • .vercel.approvers

Open the folder on GitHubat commit 82fa491

Compare with similar skills

Custom Metrics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Custom Metrics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Custom Metrics this skillvercel/vercel-plugin301—~1.6kAutomated safety check: PassCustom licence
Vercel Composition Patternssupabase/supabase111k59 repos~726Automated safety check: PassMIT
Agent Browser CLIvercel-labs/agent-browser44k24 repos~864Automated safety check: PassApache-2.0
Vercel Deploybytedance/deer-flow83k10 repos~797Automated safety check: PassMIT
Vercel Optimize Auditvercel-labs/agent-skills32k9 repos~4.3kAutomated safety check: PassNone
Sandbox Benchvercel/next.js143k—~4.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 59 repos~726 tokens
    DevelopmentAuto-check passed
  • Agent Browser CLI

    vercel-labs/agent-browser

    Official

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…

    44k GitHub starsUsed in 24 repos~864 tokens
    Productivity & AutomationAuto-check passed
  • Vercel Deploy

    bytedance/deer-flow

    Deploys a project to Vercel with one script and no login, then returns a live preview URL and a claim link for moving the deployment into your own Vercel account.

    83k GitHub starsUsed in 10 repos~797 tokens
    DevOps & CloudAuto-check passed
  • Vercel Optimize Audit

    vercel-labs/agent-skills

    Official

    Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.

    32k GitHub starsUsed in 9 repos~4.3k tokens
    DevOps & CloudAuto-check passed
  • Sandbox Bench

    vercel/next.js

    Official

    Benchmark React or Next.js changes on Vercel Sandbox VMs with paired A/B statistics: react PR/commit vs base, or Next.js PR/commit vs base, measured end-to-end through the bench/render-pipeline app…

    143k GitHub stars~4.1k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • AI SDK

    vercel-labs/ai-facts

    Official

    Answer questions about the AI SDK and help build AI-powered features.

    168 GitHub starsUsed in 21 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed

More from vercel/vercel-plugin

All 38 skills in this repo
  • Deployments Cicd

    vercel/vercel-plugin

    Official

    Vercel deployment and CI/CD expert guidance. An agent skill from vercel/vercel-plugin.

    301 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Plugin Audit

    vercel/vercel-plugin

    Official

    Audit vercel-plugin performance on real-world projects. An agent skill from vercel/vercel-plugin.

    301 GitHub stars~739 tokensUpdated yesterday
    Auto-check passed
  • Vercel CLI

    vercel/vercel-plugin

    Official

    Vercel CLI expert guidance. An agent skill from vercel/vercel-plugin.

    301 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • AI Gateway

    vercel/vercel-plugin

    Official

    Vercel AI Gateway guidance for setup, model discovery, authentication, routing, fallbacks, virtual models, evaluation models, BYOK, budgets, spend reporting, observability, compatible APIs, and…

    301 GitHub stars~4.4k tokensUpdated yesterday
    Auto-check: notes
  • Vercel Services

    vercel/vercel-plugin

    Official

    Configure and troubleshoot Vercel Services for multiple frontends and backends in one project.

    301 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Official

    Access and test Vercel deployments protected by Vercel Authentication, SSO, or Deployment Protection.

    301 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check: notes

Works with

Questions about Custom Metrics

What does Custom Metrics do?

Emit and query Vercel Custom Metrics. An agent skill from vercel/vercel-plugin. Custom Metrics is an agent skill from vercel/vercel-plugin, published by the product's own GitHub organization. Emit and query Vercel Custom Metrics.

When should I use Custom Metrics?

Custom Metrics fits situations like: instrumenting application; business measurements in Vercel Functions; using metric() from @vercel/functions; choosing metric names and attributes.

How do I install Custom Metrics in Claude Code?

Run `npx skills add vercel/vercel-plugin --skill custom-metrics -a claude-code`. Or copy the skill folder (skills/custom-metrics in vercel/vercel-plugin) into .claude/skills/custom-metrics in your project. Claude Code loads it when a task matches its description.

How do I install Custom Metrics in Codex?

Run `npx skills add vercel/vercel-plugin --skill custom-metrics -a codex`. Or copy the skill folder (skills/custom-metrics in vercel/vercel-plugin) into .agents/skills/custom-metrics in your project. Codex loads it when a task matches its description.

Can I use Custom Metrics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vercel/vercel-plugin --skill custom-metrics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/custom-metrics, .gemini/skills/custom-metrics, .github/skills/custom-metrics and .opencode/skills/custom-metrics in your project.

What does Custom Metrics need to run?

Going by SKILL.md and its folder, Custom Metrics needs the command-line tools its instructions call (pnpm).

Does Custom Metrics access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Custom Metrics safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Custom Metrics use?

Custom Metrics has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Custom Metrics use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Custom Metrics?

Skills that share tags, products or a category with Custom Metrics: Vercel Composition Patterns (supabase/supabase, 111k stars), Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Vercel Deploy (bytedance/deer-flow, 83k stars) and Vercel Optimize Audit (vercel-labs/agent-skills, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Custom Metrics?

vercel (a GitHub organization, an official publisher) maintains it in vercel/vercel-plugin, which has 301 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on October 7, 2026.

Source: vercel/vercel-plugin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.