CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Failed to scan

The risk profile of this skill

The canonical home for this skill is vercel-optimize in vercel-labs/agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 highly disciplined, metrics-first pipeline skill: concrete commands for every step, explicit validation and regen feedback loops, verbatim customer-facing copy, and clean one-level-deep reference structure. The only real defects are a missing referenced file (lib/queries.mjs) and some repetition of the scope-resolution rules across three sections.

Suggestions

Fix or remove the broken reference to lib/queries.mjs (SKILL.md line 75) — the file does not exist in the bundle; either add it under a lib/ directory or point to the actual location of the metric query registry.

Consolidate the scope-resolution guidance (linking, --scope, unscoped-usage risk) into one section — it currently appears in Prerequisites, the Step 1 prose, and the §1.1 blocker list with overlapping content — and reference it from the other two spots.

Tighten rule passages such as the Workflow-runtime and streaming guidance by stating the rule and its evidence requirement once, dropping the repeated rationale sentences.

DimensionReasoningScore

Conciseness

The body is dense and operational — nearly every line is a rule, command, or verbatim template, with no explanation of concepts Claude already knows. It falls short of a 5 because of minor redundancy: scope-resolution guidance (linking, --scope, unscoped usage risks) is repeated across Prerequisites, the Step 1 prose, and the §1.1 blocker list, and a few rule passages could be tightened without losing meaning.

4 / 5

Actionability

Every pipeline stage has copy-paste-ready bash with real script paths, arguments, and output redirection; blocker checks are given as an exact jq command; user-facing prompts are provided verbatim; and edge cases (unsupported framework, quota exhaustion, regen loop) each carry an exact command or template. This is fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The pipeline is explicitly sequenced (Collect → Blockers → Gate → Deep-dive/Reconcile → Briefs/Investigate → Collect outputs → Verify → Render) with validation checkpoints at each juncture: a JSON.parse check after collection, a blocker gate before investigation, collector failure handling for missing/duplicate/mismatched outputs, and a verify-and-regen feedback loop that reruns failed briefs and keeps regenerated output only if verification improves.

5 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level-deep links (doctrine, data-collection, candidates, recommendations, verification, scoring, scanner-patterns, observability-plus, voice, docs-library.json), and detailed material is appropriately deferred to those files. It is not a 5 because one referenced path, lib/queries.mjs ("The metric registry is lib/queries.mjs"), does not exist in the bundle — a broken reference that undermines navigation.

4 / 5

Total

18

/

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: it states a concrete three-stage pipeline, scopes supported frameworks, and closes with an explicit trigger clause full of natural, Vercel-specific phrases a user would actually say. Third-person imperative voice, no fluff, no over-claims.

DimensionReasoningScore

Specificity

The description lays out a complete concrete pipeline — "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" — naming multiple specific actions with comprehensive coverage of the audit workflow. It is not a 4 because the coverage is complete rather than having minor gaps, and not lower because no part is vague or generic.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the three-stage collect → investigate → recommend pipeline with named inputs and outputs, and the "when" is an explicit "Trigger for ..." clause listing concrete request phrases. This is the anchor-5 pattern (clear what + explicit when with concrete triggers).

5 / 5

Trigger Term Quality

Trigger terms are exactly what a Vercel user would say or see on an invoice: "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", with natural synonyms (bill reduction / cost breakdown; slow / expensive). This matches the comprehensive-synonyms anchor, and nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — Vercel cost and performance optimization on deployed Next.js/SvelteKit/Nuxt/Astro projects — and triggers are tied to Vercel-specific billing and product terms (Function Invocations, Build Minutes, Fast Data Transfer, Fluid compute), so overlap with other skills is minimal.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

boranfurkan/planb-hackathon

Path

skills/.agents/skills/vercel-optimize/SKILL.md

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.