add-function-examples

Guide for adding new AI function examples, for testing specific features against the actual provider APIs.

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/add-function-examples/SKILL.md

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.

The body is concise, actionable, and well-structured with a clear sequence and an included type-check validation step. It would benefit from an explicit error-retry loop and a small example-file template to push actionability and workflow clarity to the top anchor.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence, with concrete paths and commands; only the mid-paragraph sentence about what examples are 'used for' slightly restates the description and could be trimmed.	4 / 5
Actionability	Gives concrete, executable guidance (specific directory, generateText/streamText variants, `pnpm type-check:full`) with a minor gap: no template or example of an actual example file's structure.	4 / 5
Workflow Clarity	A clear sequence (review changes → identify → determine model/function → create variants → type-check → fix) with a validation checkpoint, though the fix loop is stated implicitly rather than as an explicit validate→fix→retry cycle.	4 / 5
Progressive Disclosure	Under 50 lines, single-purpose, no bundle files, and organized under one clear section header — meets the simple-skill exception for a top progressive-disclosure score.	5 / 5
	Total	17 / 20 Passed

Description

53%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.

The description clearly states what the skill does and targets a reasonably distinct niche, but it lacks an explicit 'Use when...' trigger clause and offers only modest trigger-term coverage, capping completeness and trigger quality at the midpoint.

Suggestions

Add an explicit trigger clause such as 'Use when adding or updating examples in examples/ai-functions to test a feature against a provider API.'

Broaden trigger terms with natural synonyms users might say (e.g. 'samples', 'test cases', 'function examples').

Mention the generateText/streamText variant split in the description to raise specificity beyond two generic actions.

Dimension	Reasoning	Score
Specificity	Names the domain ('adding new AI function examples') and two concrete actions (adding examples, testing features against provider APIs), but coverage is not comprehensive — no mention of variant creation or validation.	3 / 5
Completeness	It has a clear 'what' (a guide for adding/testing function examples) but no 'Use when...' trigger clause, which per the guidelines caps completeness at 3.	3 / 5
Trigger Term Quality	Contains relevant phrases like 'AI function examples' and 'provider APIs' that a user might say, but misses common synonyms and variations (e.g. 'samples', 'test cases', specific function names).	3 / 5
Distinctiveness Conflict Risk	The niche of 'AI function examples for testing against actual provider APIs' is fairly distinct and unlikely to conflict with unrelated skills, with only minor overlap risk against general testing skills.	4 / 5
	Total	13 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning

	Total	14 / 16 Passed

Repository: vercel/ai
Path: skills/add-function-examples/SKILL.md
Commit: c3c189c

Reviewed: ~5 hours ago

Table of Contents

Discovery Implementation Validation

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.