Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.
75
66%
Does it follow best practices?
Impact
100%
1.58xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/ai-gateway/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid description with explicit trigger guidance and a clear niche. The 'Use when' clause with specific scenarios is well-constructed and the domain is distinctive. The main weakness is that the 'what' portion is somewhat vague ('expert guidance') rather than listing concrete actions the skill enables.
Suggestions
Replace 'expert guidance' with more specific concrete actions, e.g., 'Configures model routing rules, sets up provider failover chains, tracks API costs, and manages multi-provider setups through Vercel AI Gateway's unified API.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Vercel AI Gateway) and lists several actions/areas (model routing, provider failover, cost tracking, managing multiple AI providers), but uses somewhat general terms like 'expert guidance' rather than listing concrete specific actions like 'configure fallback chains' or 'set up rate limiting'. | 2 / 3 |
Completeness | Clearly answers both what ('Vercel AI Gateway expert guidance') and when ('Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API') with an explicit 'Use when' clause listing specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'model routing', 'provider failover', 'cost tracking', 'multiple AI providers', 'unified API', and 'Vercel AI Gateway'. These are terms a user working with this technology would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — 'Vercel AI Gateway' is a specific product, and the combination of model routing, provider failover, and unified API management creates a clear niche that is unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is highly actionable with excellent, executable code examples covering all major AI Gateway features. However, it is severely over-long and monolithic — it tries to be a complete reference manual rather than a concise skill file with progressive disclosure. Much of the content (pricing, provider lists, marketing benefits, audit logging details, time-sensitive model information) either doesn't belong in a skill file or should be split into separate reference files.
Suggestions
Split into a concise SKILL.md overview (~100 lines max) covering setup, basic usage, and routing, with separate files for CACHING.md, ERROR_HANDLING.md, COST_CONTROLS.md, CLAUDE_CODE.md, and AUDIT_LOGGING.md
Remove marketing/informational content that doesn't guide action: 'Key Benefits' section, 'Supported Providers' list, 'Pricing' details, and the 'Latest Model Availability' section with specific dates and prices that will become stale
Add a validation step after authentication setup (e.g., 'Verify connection: run this test script to confirm gateway access works')
Remove redundant decision aids — the 'When to Use AI Gateway' table and the decision tree convey the same information; keep only the more concise one
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~400+ lines. It explains concepts Claude already knows (what OIDC is, what caching strategies are, what audit logging captures), includes marketing-style content ('Key Benefits', 'Zero markup' pricing details), and has significant redundancy — the 'When to Use AI Gateway' table duplicates the decision tree. The pricing section, supported providers list, and 'Latest Model Availability' with specific dates/prices are token-heavy and will become stale quickly. | 1 / 3 |
Actionability | The skill provides fully executable, copy-paste-ready TypeScript code examples throughout — setup, routing configuration, error handling, caching, rate limiting, streaming, and Claude Code configuration. The complete error handling template and environment variable examples are particularly actionable. | 3 / 3 |
Workflow Clarity | The authentication setup has a clear sequence (vercel link → enable in dashboard → vercel env pull), and the error handling template provides a good pattern. However, there are no explicit validation checkpoints — for example, after setting up OIDC auth there's no 'verify your connection works' step, and the overall document reads more like a reference than a guided workflow. The decision tree for Gateway vs Direct is helpful but the document lacks a clear end-to-end 'getting started' workflow with verification. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with no bundle files to offload content to. Sections like Cache-Control, Audit Logging, Budget Alerts, Claude Code Compatibility, Multimodal Support, and Pricing could each be separate reference files. The skill tries to be a comprehensive reference document rather than an overview with pointers, resulting in massive token consumption on every load. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
63%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 7 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (666 lines); consider splitting into references/ and linking | Warning |
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 | 7 / 11 Passed | |
61f1903
Table of Contents
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.