CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vercel-services

Configure and troubleshoot Vercel Services for multiple frontends and backends in one project. Use when composing a polyglot or multi-service application on one Vercel deployment; defining the `services` key, service-targeted rewrites, or service bindings in `vercel.json`; or running all services with `vercel dev`.

Quality

90%

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

93%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.

Excellent body content: dense, expert-level, fully actionable with copy-paste-ready configuration examples and a strong troubleshooting section. The only meaningful gap is the absence of an explicit post-deploy validation step in the happy path, with verification handled reactively via troubleshooting instead.

DimensionReasoningScore

Conciseness

The body is lean and expert-level throughout: no padding, no explanation of concepts Claude already knows, and every sentence carries non-obvious information (e.g., 'Routing into a service is final. If the selected service returns a 404 or 405, Vercel does not try the next top-level rewrite'; 'Native Go and Rust runtime services cannot currently consume bindings'). Even the Beta note is actionable instruction ('Say so when you recommend it'), matching the 'every token earns its place' anchor.

5 / 5

Actionability

Fully executable guidance: multiple copy-paste-ready vercel.json examples covering the common cases (frontend+backend with bindings, prefix stripping, SPA catch-all, host-matched subdomain), concrete commands (`vercel dev`, `vercel dev -L`, `vercel`), a runtime bindings code snippet, and specific field-level directions (`root`, `entrypoint`, `runtime: "container"`, `format: "url"`).

5 / 5

Workflow Clarity

Sections form a clear sequence (choose structure → define services → route → bind → develop/deploy → troubleshoot), and the Troubleshoot section is a symptom-to-fix feedback loop for error recovery. It falls short of 5 because the happy path has no explicit validation checkpoint (e.g., no 'after deploying, verify /api reaches the backend' step) — verification is left to the after-the-fact Troubleshoot list.

4 / 5

Progressive Disclosure

Well-organized sections with the one genuinely separable concern (the legacy `experimentalServices` model) split into a real, one-level-deep reference file that is clearly signaled at both mention points ('read [references/experimental-services.md] before changing it'). The remaining content is core workflow guidance that belongs inline, matching the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

19

/

20

Passed

Description

87%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.

A strong description that explicitly covers what the skill does and when to use it, with concrete, niche-specific trigger terms including the config file and CLI command. The main gaps are a couple of missing common synonyms and capability verbs that stay at the 'configure and troubleshoot' level.

Suggestions

Add 'monorepo' (and optionally 'microservices') to the 'Use when' clause, since users commonly describe this exact scenario with those words.

Consider naming the concrete troubleshooting scenarios the skill covers (e.g., backend 404s on /api routes, deep-link 404s in SPAs) so the 'troubleshoot' half of the what-clause is as specific as the 'configure' half.

DimensionReasoningScore

Specificity

The description names the domain ('Vercel Services for multiple frontends and backends in one project') and lists several concrete actions and artifacts ('Configure and troubleshoot', 'defining the `services` key, service-targeted rewrites, or service bindings in `vercel.json`', 'running all services with `vercel dev`'), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because the capability verbs are only 'configure' and 'troubleshoot', and above 3 because specific sub-tasks and config artifacts are explicitly enumerated.

4 / 5

Completeness

It clearly answers both 'what' ('Configure and troubleshoot Vercel Services for multiple frontends and backends in one project') and 'when' via an explicit 'Use when composing a polyglot or multi-service application... defining the `services` key... or running all services with `vercel dev`' clause with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'multiple frontends and backends', 'polyglot', 'multi-service application', 'services key', 'service bindings', 'vercel.json', and 'vercel dev' are all phrases users would naturally say. A few common terms are missing (e.g., 'monorepo', 'microservices'), which fits the 'good coverage; a few natural terms missing' anchor rather than the comprehensive synonym-and-extension coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a named product feature with distinct triggers (`services` key, service-targeted rewrites, service bindings in `vercel.json`, `vercel dev`), and phrases like 'in one project' and 'one Vercel deployment' separate it clearly from adjacent skills such as microfrontends or general deployment skills — minimal conflict risk.

5 / 5

Total

18

/

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

Path

skills/vercel-services/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.