CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-gateway

Vercel AI Gateway guidance for setup, model discovery, authentication, routing, fallbacks, virtual models, evaluation models, BYOK, budgets, spend reporting, observability, compatible APIs, and coding-agent configuration. Use when adding AI Gateway to an app, migrating provider calls, choosing models or providers, centralizing model configuration, evaluating application state, debugging gateway requests, or running `vercel ai-gateway` commands.

1.05x
Quality

88%

Does it follow best practices?

Impact

100%

1.05x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 well-engineered operational skill: executable commands and code, a validated workflow with a verification checklist, and clean progressive disclosure into six real, appropriately scoped reference files. The only weakness is mild redundancy in the repeated verify-current-sources instructions and the long link list, which slightly dilute token efficiency.

DimensionReasoningScore

Conciseness

The body is dense and operational ('Plain model strings route through AI Gateway. Add `@ai-sdk/gateway` only when the task needs...') and assumes Claude's competence, but the verify-from-current-sources instruction recurs across the intro, 'Start with current sources', and the CLI section, and the 13-link documentation list could be trimmed. This sits above anchor 3 (mostly efficient) but short of anchor 5's 'every token earns its place'.

4 / 5

Actionability

Fully executable guidance throughout: 'curl -fsSL https://ai-gateway.vercel.sh/v1/models', a complete TypeScript example with an env-var guard, exact baseURL values per SDK ('point `baseURL`... to `https://ai-gateway.vercel.sh/v1`'), and a concrete CLI subcommand table. Copy-paste ready commands cover the common cases, matching the anchor-5 example.

5 / 5

Workflow Clarity

The 9-step 'Implementation workflow' has explicit validation checkpoints ('Run the project's formatter, type checker, and focused tests', 'Verify the request in AI Gateway Logs'), enumerated error outcomes, and authorization gating for outward-facing actions, reinforced by a 9-item 'Verification checklist'. This matches anchor 5's sequence-plus-validation-plus-checklist pattern, and the destructive/batch cap does not apply since validation is present.

5 / 5

Progressive Disclosure

The SKILL.md is a clear overview with a job-to-reference routing table ('Route the request to the right guide'); all six cited files exist in references/, are one level deep with only sibling cross-links, and detail is appropriately split (main file 293 lines vs. 91-296 line references). This matches anchor 5's 'clear overview with well-signaled one-level-deep references'.

5 / 5

Total

19

/

20

Passed

Description

83%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 answers both what the skill covers and when to use it, with a broad, concrete capability list and natural trigger terms. Its only deductions are the noun-list framing of the capability sentence, a few missing user synonyms, and minor overlap potential with a general AI SDK skill.

DimensionReasoningScore

Specificity

The first sentence enumerates twelve concrete capability areas ('setup, model discovery, authentication, routing, fallbacks, virtual models, evaluation models, BYOK, budgets, spend reporting, observability...') and the trigger clause adds seven concrete actions ('adding AI Gateway to an app, migrating provider calls... debugging gateway requests, or running `vercel ai-gateway` commands'). It falls short of anchor 5 because the capability list is topic nouns under 'guidance for' rather than the verb-driven action list of the anchor-5 example, but is well above anchor 3's 1-2 actions.

4 / 5

Completeness

Both halves are explicit: a clear what ('Vercel AI Gateway guidance for setup, model discovery, authentication, routing, fallbacks...') followed by an explicit 'Use when adding AI Gateway to an app, migrating provider calls, choosing models or providers... or running `vercel ai-gateway` commands' with concrete triggers. This mirrors the anchor-5 example's structure exactly; anchor 4's weaker 'when' does not apply.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'AI Gateway', 'virtual models', 'BYOK', 'budgets', 'spend reporting', 'fallbacks', and the CLI invocation 'vercel ai-gateway commands'. A few natural synonyms users might say are missing (e.g., 'failover', 'credits', 'model router'), so it does not reach anchor 5's comprehensive synonym-and-extension coverage.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a specific named product with distinct product terms (virtual models, BYOK, gateway budgets), giving it a clear niche. Minor overlap risk remains with a closely related AI SDK skill via generic phrases like 'choosing models or providers' and 'migrating provider calls', which matches anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

17

/

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/ai-gateway/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.