CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vercel-api

Vercel app and REST API expert guidance. Use when the agent needs live access to Vercel projects, deployments, environment variables, domains, logs, or documentation through the connected Vercel app or REST API.

64

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/vercel/skills/vercel-api/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 actionable, well-sectioned API reference with executable examples for every access path (MCP, REST, SDK, CLI) and a useful MCP-vs-CLI-vs-REST decision table. Its weaknesses are the monolithic single-file structure — a large endpoint table and multiple SDK examples that should live in reference files — and minor marketing padding.

Suggestions

Move the 18-row endpoint table and the SDK code examples into references/ files (e.g. references/endpoints.md, references/sdk-examples.md), keeping SKILL.md to connection setup, the decision table, and cross-references.

Delete non-actionable marketing lines such as 'Used in production by Zapier, Composio, Vapi, and Solana'.

Add an explicit verification step to the write-oriented guidance (e.g. after creating an env var, re-list env vars to confirm it appears in the target environments).

DimensionReasoningScore

Conciseness

The body is dense reference material — endpoint tables, executable curl/SDK/CLI snippets, and a decision table — with almost no explanation of concepts Claude already knows. Minor trimmable padding keeps it below 5: 'Used in production by Zapier, Composio, Vapi, and Solana' is marketing fluff, and the intro paragraph ('You are an expert in...') adds little. Not 3 because none of the sections are genuinely unnecessary explanation.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready across every access path: a working curl with auth header, complete @vercel/sdk snippets (list deployments, create env var with target/type fields, list domains, create log drain), a REST endpoint table with methods, and exact 'vercel api' CLI invocations including a --body example. Common cases are covered with specific, runnable code.

5 / 5

Workflow Clarity

The usage patterns give clear, coherent numbered sequences ('List recent deployments → find the failed one / Inspect deployment → get error summary / Query build logs → identify root cause'), each ending in an implicit checkpoint (root cause, verified domain assignment). It stays at 4 rather than 5 because the write-oriented guidance (create env var, create/delete drain) includes no verification step after mutation.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~255-line body inlines substantial material that clearly belongs in separate reference files — the 18-row endpoint table, four full SDK examples, and the drains payload schemas (deferred only by a 'see ⤳ skill: observability' pointer, which is one level deep and well signaled). Section headers and cross-references are well organized, but the bulk API reference inline matches the 'could be better organized' anchor rather than an appropriately split structure.

3 / 5

Total

16

/

20

Passed

Description

75%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 with an explicit 'Use when...' trigger and a concrete enumeration of Vercel resource areas. Its main weaknesses are the action-free 'expert guidance' framing for the 'what' and missing common trigger synonyms like VERCEL_TOKEN or api.vercel.com.

Suggestions

Replace 'expert guidance' with concrete verbs, e.g. 'List and inspect Vercel projects, deployments, environment variables, domains, and logs; create deployments and env vars via the REST API.'

Add high-frequency trigger terms users actually say — 'VERCEL_TOKEN', 'api.vercel.com', 'Vercel dashboard' — to broaden natural-match coverage.

DimensionReasoningScore

Specificity

The description enumerates concrete resource areas — 'Vercel projects, deployments, environment variables, domains, logs, or documentation' — and names two access mechanisms ('connected Vercel app or REST API'). It falls short of 5 because 'expert guidance' states no concrete actions/verbs (list, inspect, create, manage), relying on resource nouns to imply capabilities.

4 / 5

Completeness

Both parts are explicit: what — 'Vercel app and REST API expert guidance' — and when — 'Use when the agent needs live access to Vercel projects, deployments...'. The 'when' clause is concrete and trigger-rich, but the 'what' ('expert guidance') is slightly generic, so it does not reach the fully concrete 5 anchor.

4 / 5

Trigger Term Quality

Natural terms a user would say are well covered: 'Vercel', 'projects', 'deployments', 'environment variables', 'domains', 'logs', 'documentation', 'REST API'. Not 5 because common variations are absent — no 'Vercel CLI', 'api.vercel.com', 'VERCEL_TOKEN', or '.vercel' path mentions that users asking Vercel questions would frequently use.

4 / 5

Distinctiveness Conflict Risk

The Vercel-specific scope and named resource types give it a clear niche with minimal conflict against unrelated skills. Minor overlap risk remains with closely related sibling skills (vercel-cli, vercel-functions, vercel-storage) whose domains intersect deployment/env-var operations, keeping it below 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 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

Total

14

/

16

Passed

Repository

openai/plugins

Path

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