CtrlK
BlogDocsLog inGet started
Tessl Logo

custom-metrics

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.

78

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, well-structured single-purpose skill: executable emit and query examples, a clear emit→deploy→discover workflow with explicit validation and a troubleshooting checklist, and crisp boundary guidance against adjacent signals. It never explains concepts Claude already knows and contains no time-sensitive or deprecated-pattern material.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout: install command, import snippet, signature, bullet semantics, a compact emit/query aggregation table, CLI examples, and boundary guidance. Every statement carries Vercel-specific knowledge Claude would not already have (reserved "vercel." prefix, no-op behavior, Observability Plus requirement) — nothing explains known concepts, fitting the score-5 anchor ('every token earns its place') rather than score-4's 'minor instances of over-explanation'.

5 / 5

Actionability

Guidance is fully executable and copy-paste ready: `pnpm add @vercel/functions`, a complete TypeScript handler demonstrating success/error/finally emission, the exact `metric(name, value, tags?)` signature, and concrete `vc metrics schema` / `vc metrics orders.created -a sum --group-by outcome --since 24h` commands with flags including `--format=json`. Common cases (increment, duration, group-by, percentiles) are all covered, matching the score-5 anchor.

5 / 5

Workflow Clarity

The workflow is stated upfront ("emit a numeric sample with metric() → invoke the deployed function → discover and query the metric") and sections follow that order. Explicit validation is present ("Verify instrumentation through a deployed Vercel Function invocation, not local execution alone"; "Always inspect the exact metric first with vc metrics schema") plus a numbered 5-step error-recovery checklist for missing metrics — a genuine feedback loop matching the score-5 anchor.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are needed: the ~90-line body is single-purpose, overview-level, and organized into well-labeled sections (Emit, Model, Discover and query, Use the right signal) with nothing inlined that clearly belongs in a separate file. Per the simple-skill guidance, well-organized sections alone justify the top score; the score-4 anchor would require identifiable organization gaps, and there are none.

5 / 5

Total

20

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: a concise third-person statement of capability followed by an explicit 'Use when' clause enumerating concrete triggers, with exact API (metric(), @vercel/functions) and CLI (vc metrics) terms. It matches the structure and quality of the rubric's good overall examples with no padding or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Emit and query Vercel Custom Metrics", "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" — covering the domain comprehensively with the exact API and CLI surface, matching the top anchor ('multiple specific concrete actions; comprehensive coverage') rather than the score-4 anchor which implies minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the 'what' is "Emit and query Vercel Custom Metrics" and the 'when' is an explicit "Use when" clause with concrete trigger phrases (instrumenting measurements, using metric(), choosing names/attributes, querying with vc metrics). This mirrors the score-5 anchor example's structure; the score-4 anchor ('when could be more explicit') does not fit since the when-clause enumerates four specific triggers.

5 / 5

Trigger Term Quality

Natural trigger terms are covered comprehensively including synonyms and exact technical artifacts: "Vercel Custom Metrics", "metric()", "@vercel/functions", "vc metrics", "Vercel Functions", "measurements". Users would naturally say these when needing this skill; it is not merely score-4 ('a few natural terms missing') because both the colloquial (metrics, measurements) and exact technical forms are present.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — Vercel Custom Metrics via metric()/@vercel/functions and vc metrics — with triggers unlikely to fire for adjacent skills (Web Analytics, OpenTelemetry, logging). Distinctive product-specific tokens make conflict risk minimal, fitting the score-5 anchor rather than score-4's 'minor overlap risk with closely related skills'.

5 / 5

Total

20

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
vercel/vercel-plugin
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.