CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

develop-ai-functions-example

Develop examples for AI SDK functions. Use when creating, running, or modifying examples under examples/ai-functions/src to validate provider support, demonstrate features, or create test fixtures.

1.33x
Quality

86%

Does it follow best practices?

Impact

87%

1.33x

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

82%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-structured, highly actionable single-file skill: complete code templates, exact commands, and concrete naming conventions dominate the body, with a verification-driven bug-repro workflow. Weaker spots are the slightly padded Best Practices section and the absence of an explicit run-to-verify checkpoint in the example-authoring workflow.

Suggestions

Add an explicit validation checkpoint to the authoring workflow (e.g., "after writing an example, run it with pnpm tsx to confirm it executes before committing").

Trim the generic Best Practices items ("Keep examples focused", "Add comments for complex logic") that restate what the templates and structure sections already demonstrate.

Consider moving the per-function code templates into a references/ file so SKILL.md stays a lean overview, if the skill is expected to grow.

DimensionReasoningScore

Conciseness

The body is efficient — tables for directory and naming conventions, four copy-paste TypeScript templates, and exact run commands, with no explanation of concepts Claude already knows. It is not 5 because the generic "Best Practices" items ("Keep examples focused", "Add comments for complex logic") and some "Utility Helpers" repetition could be trimmed.

4 / 5

Actionability

Guidance is fully executable: complete templates for the common cases (basic, streaming, tool calling, structured output) plus exact commands like "pnpm tsx src/generate-text/openai/basic.ts" and concrete naming patterns with worked examples. The providerName/model-id placeholders are explicitly justified flexibility (provider varies), not gaps, matching anchor 5.

5 / 5

Workflow Clarity

The bug-reproduction workflow is clearly sequenced with an explicit verification loop ("Use a temporary script... to reproduce the failure end-to-end, then rerun it to verify the fix" and document before/after), and "When to Write Examples" gives decision guidance. It is not 5 because the primary example-authoring workflow lacks an explicit checkpoint to run and confirm the new example works.

4 / 5

Progressive Disclosure

No bundle files exist, so all content lives in a single SKILL.md; it is well-sectioned with clear headers, scannable tables, and clearly signaled external pointers (AGENTS.md bug-fix workflow, capture-api-response-test-fixture skill). This matches anchor 4's good structure with minor organization gaps; it does not meet the simple-skill exception for 5 since the file is well over 50 lines and the four inline templates could plausibly live in reference files.

4 / 5

Total

17

/

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: it states concrete capabilities in third person, includes an explicit and specific "Use when" clause tied to a concrete directory and purposes, and occupies a distinct niche. The main gap is trigger-term breadth — the AI SDK function names and provider names that users would most naturally mention are missing.

Suggestions

Include the concrete AI SDK function names (e.g., generateText, streamText, generateObject) in the description so it triggers when users ask for an example of a specific function.

Mention common provider names (e.g., OpenAI, Anthropic, Bedrock) as trigger terms for users asking to add or test a specific provider.

DimensionReasoningScore

Specificity

Quotes like "Develop examples for AI SDK functions", "creating, running, or modifying examples", "validate provider support", and "create test fixtures" list several concrete actions and purposes, matching the anchor for several specific actions with minor gaps. It is not 5 because "demonstrate features" is generic and the action list is not fully comprehensive.

4 / 5

Completeness

It explicitly answers both: the "what" ("Develop examples for AI SDK functions") and a concrete "when" ("Use when creating, running, or modifying examples under examples/ai-functions/src to validate provider support, demonstrate features, or create test fixtures") with specific trigger conditions. Anchor 4's caveat that the "when" could be more explicit does not apply here.

5 / 5

Trigger Term Quality

Natural terms such as "examples", "AI SDK functions", "provider support", and "test fixtures" give good keyword coverage, matching anchor 4. It falls short of anchor 5's comprehensive synonym/extension coverage because the function names users would actually say (e.g., generateText, streamText) and provider names are absent.

4 / 5

Distinctiveness Conflict Risk

The trigger is pinned to a specific location and purpose ("examples under examples/ai-functions/src to validate provider support"), giving it a clear niche with distinct triggers and minimal conflict risk, matching anchor 5. It is not merely "mostly distinct" as in anchor 4.

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

13

/

16

Passed

Repository

vercel/ai

Path

skills/develop-ai-functions-example/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.