CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-function-examples

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

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

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 a tight, actionable instruction set for an internal repo workflow: concrete paths, function names, and a validation command with a fix loop, and no wasted tokens. Its only shortfalls are minor — an implicit rather than enumerated step order and no sample of an example file's naming or structure.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no concepts are over-explained, and each paragraph delivers instructions. The sentence 'These examples are used for testing specific features against the actual provider APIs, and can also serve as documentation for users' is a minor trimmable redundancy with the frontmatter description, keeping it just below the every-token-earns-its-place anchor (5).

4 / 5

Actionability

Guidance is concrete and executable: the target directory ('examples/ai-functions'), specific top-level functions ('generateText', 'streamText', 'generateImage', 'generateSpeech'), a runnable command ('pnpm type-check:full'), and links to the bug-fix workflow and PR template. Minor gaps — no example of file naming/structure for a new example — keep it below fully copy-paste-ready coverage (5), but it is well above pseudocode-level guidance (3).

4 / 5

Workflow Clarity

The paragraphs form a clear sequence (review branch changes → determine model kind and function → create variants → run type-check and fix errors) with an explicit validation checkpoint ('run `pnpm type-check:full`; fix any errors encountered'). It falls short of anchor 5 because the sequence is implicit in paragraph order rather than enumerated steps, and it is clearly above anchor 3's missing-checkpoint level.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external bundle files (none exist); it is well-organized with clearly signaled one-level-deep references ([bug-fix workflow in AGENTS.md](../../AGENTS.md#bug-fixes) and `.github/pull_request_template.md`). Per the simple-skill guideline, this qualifies for 5 with just well-organized sections.

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 is concise and names a specific niche with a clear 'what', but it lacks any explicit 'Use when...' trigger guidance and its natural-keyword coverage is thin, capping completeness and trigger quality at the midpoint. Adding explicit trigger conditions and a few concrete actions would lift it substantially.

Suggestions

Add an explicit 'Use when...' clause with concrete triggers, e.g. 'Use when adding or updating examples in examples/ai-functions, or when verifying a feature against a live provider API.'

Include natural keyword variations users would actually say, such as 'function example', 'sample', 'e2e verification', or 'live API test', to improve trigger term coverage.

List one or two more concrete actions to round out coverage, e.g. 'create generateText/streamText variants and run type-checks' alongside adding the example.

DimensionReasoningScore

Specificity

The description names the domain ('adding new AI function examples') with one concrete action plus a purpose clause ('for testing specific features against the actual provider APIs'), which matches the 1-2 concrete actions anchor. It does not list several specific actions (not 4), but its concrete domain terms lift it above the generic level (not 2).

3 / 5

Completeness

It has a clear 'what' ('Guide for adding new AI function examples...') but no 'Use when...' clause or equivalent explicit trigger guidance; the 'for testing specific features' phrase only weakly implies when. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

It includes some relevant keywords ('function examples', 'testing', 'provider APIs') but misses common natural variations users would say, such as 'sample', 'e2e test', 'live API test', or file-path mentions. Coverage is present but incomplete, matching the 'some relevant keywords' anchor rather than good coverage (4) or generic-only (2).

3 / 5

Distinctiveness Conflict Risk

The niche is specific — adding AI function examples for testing against actual provider APIs — so overlap risk is limited to closely related testing/example skills. It is mostly distinct with minor overlap risk (anchor 4), not fully minimal-risk (5) because it lacks distinct trigger phrases that would separate it from general testing skills.

4 / 5

Total

13

/

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/add-function-examples/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.