CtrlK
BlogDocsLog inGet started
Tessl Logo

ai-sdk

Vercel AI SDK expert guidance. Use when building AI-powered features — chat interfaces, text generation, structured output, tool calling, agents, MCP integration, streaming, embeddings, reranking, image generation, or working with any LLM provider.

88

4.78x
Quality

88%

Does it follow best practices?

Impact

91%

4.78x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured skill that provides clear, actionable guidance for working with the Vercel AI SDK. Its strongest aspects are the concrete commands, clear workflow sequences with fallback chains, and excellent progressive disclosure through well-organized reference files. The main weakness is slight verbosity in the 'Critical' section where the distrust-your-knowledge message is reinforced more than necessary.

DimensionReasoningScore

Conciseness

Generally efficient but has some unnecessary verbosity. The 'Critical: Do Not Trust Internal Knowledge' section is somewhat heavy-handed, and the explanation 'Everything you know about the AI SDK is outdated or wrong' is repeated conceptually multiple times. The curl command in point 7 is long but justified. Some points like 'Be minimal' are good meta-instructions but the overall section could be tighter.

2 / 3

Actionability

Provides concrete, executable commands throughout: specific grep patterns for searching docs, a complete curl command for fetching model IDs, clear file paths to check (node_modules/ai/docs/, node_modules/ai/src/), and a specific URL pattern for searching ai-sdk.dev. The troubleshooting flow for typecheck failures is also concrete and actionable.

3 / 3

Workflow Clarity

Clear sequenced workflows with validation checkpoints: Prerequisites establish a clear first step, the numbered list in 'Critical' section provides a clear decision sequence, the 'When Typecheck Fails' section has an explicit fallback chain (check common-errors → search local → search online), and the agent building section has a clear detect-framework-first workflow. The typecheck step (point 8) serves as a validation checkpoint.

3 / 3

Progressive Disclosure

Excellent structure with a clear overview in SKILL.md and well-signaled one-level-deep references to four specific reference files (common-errors.md, ai-gateway.md, type-safe-agents.md, devtools.md). References are contextually linked where relevant (e.g., common errors mentioned both in the typecheck section and the references section). The content appropriately keeps high-level guidance inline while deferring detailed references.

3 / 3

Total

11

/

12

Passed

Description

92%

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 strong description that clearly identifies its domain (Vercel AI SDK) and provides comprehensive trigger terms covering the breadth of the SDK's capabilities. The explicit 'Use when...' clause with a detailed list of scenarios is well-constructed. The main weakness is that many trigger terms are generic AI/ML concepts that could overlap with other skills, though the 'Vercel AI SDK' anchor helps differentiate it.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and capabilities: chat interfaces, text generation, structured output, tool calling, agents, MCP integration, streaming, embeddings, reranking, image generation, and working with LLM providers.

3 / 3

Completeness

Clearly answers both what ('Vercel AI SDK expert guidance' covering specific capabilities) and when ('Use when building AI-powered features') with an explicit 'Use when...' clause followed by a comprehensive list of trigger scenarios.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say when building AI features: 'chat interfaces', 'text generation', 'structured output', 'tool calling', 'agents', 'streaming', 'embeddings', 'image generation', 'LLM provider', 'Vercel AI SDK'. These are all terms developers naturally use.

3 / 3

Distinctiveness Conflict Risk

While 'Vercel AI SDK' is a distinct niche, many of the trigger terms like 'text generation', 'streaming', 'embeddings', 'image generation', and 'tool calling' are very broad and could easily overlap with other AI/LLM-related skills. The description could conflict with general LLM usage skills or other AI framework skills.

2 / 3

Total

11

/

12

Passed

Validation

72%

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

Validation8 / 11 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

8

/

11

Passed

Repository
vercel/vercel-plugin
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.