CtrlK
BlogDocsLog inGet started
Tessl Logo

capture-api-response-test-fixture

Capture API response test fixture.

60

0.55x
Quality

61%

Does it follow best practices?

Impact

50%

0.55x

Average score across 2 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/capture-api-response-test-fixture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

93%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 an exemplary lean skill: it captures non-obvious repo conventions and provides fully executable, copy-paste-ready examples for both the doGenerate and doStream cases with exact paths and commands. The only minor gap is that the generateText workflow leaves the run step implicit and neither flow includes a verification checkpoint for the resulting fixture.

DimensionReasoningScore

Conciseness

The body is lean and every sentence conveys repo-specific knowledge Claude could not infer (fixture storage convention, semantics-preserving trimming of large responses, exact fixture and example paths, the includeRawChunks/saveRawChunks mechanics). It explains no general concepts and includes no padding, matching the anchor 'Lean and efficient; assumes Claude's competence; every token earns its place'.

5 / 5

Actionability

Both workflows ship copy-paste-ready TypeScript that imports real repo helpers (run, saveRawChunks), and the streamText section even gives the exact execution command ('pnpm tsx src/stream-text/<provider>/<script-name>.ts') and output location. The examples cover the two common cases (doGenerate and doStream), matching the anchor 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Each flow has a clear sequence (place script in the provider directory, run it, copy the logged/saved output into a renamed fixture), and the streamText path states the run command and output folder explicitly. It stays at 4 rather than 5 because the generateText flow implies running the script without stating the command, and there is no checkpoint confirming a fixture was created correctly; it is above anchor 3 because both sequences and their artifact destinations are explicit rather than implicit.

4 / 5

Progressive Disclosure

This is a short (~45 line) single-purpose skill with no need for external bundle files, and the content is organized into clearly scoped sections (conventions, generateText, streamText). Per the rubric's simple-skill guidance, well-organized sections alone warrant a 5; the in-body pointers to real repo paths (fixture folder, test file, /examples/ai-functions) aid navigation without any nested references.

5 / 5

Total

19

/

20

Passed

Description

28%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 a terse title-like label rather than a functional description: it names the domain but enumerates no concrete capabilities and provides no 'use when' trigger guidance, so it would rarely be selected at the right moment. It is specific enough to avoid broad conflicts, but trigger-term coverage and completeness are weak.

Suggestions

Add an explicit trigger clause, e.g. 'Use when adding or updating provider response parsing tests, capturing raw provider responses, or creating test fixtures for doGenerate/doStream.'

Enumerate the concrete capabilities instead of a single generic verb, e.g. 'Capture raw provider responses via generateText and streamText scripts, store them as test fixtures in __fixtures__ folders, and trim oversized responses without changing semantics.'

Include natural trigger-term variations users would actually say, such as 'API responses', 'raw chunks', 'provider tests', and 'test fixtures', to improve keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain ("API response test fixture") via a single generic verb "Capture" with no enumerated actions, matching the anchor 'Names the domain but actions are minimal or generic' (cf. "Processes PDF files"). It does not reach 3 because no concrete actions beyond the single capture verb are listed, and is above 1 because the domain itself is named rather than being pure abstraction.

2 / 5

Completeness

The description offers a vague noun-phrase 'what' ("Capture API response test fixture") and contains no 'when' guidance whatsoever; the judging guidelines explicitly cap completeness at 3 for a missing 'Use when...' clause, and this case fits anchor 2 ('Has a vague what and no when'). It is above anchor 1 because the what is at least topic-specific, but cannot reach 3 without either explicit actions or a use-when trigger.

2 / 5

Trigger Term Quality

Only "API response" and "test fixture" appear — a couple of relevant but terse keywords with no natural phrases or variations a user would actually say (e.g. "provider responses", "raw response", "fixtures for provider tests"). This matches anchor 2 ('One or two generic keywords; missing the natural phrases users say'); it is above anchor 1 because the terms are domain-relevant rather than entirely generic, and below anchor 3 because common synonyms and variations are absent.

2 / 5

Distinctiveness Conflict Risk

"Capture API response test fixture" is a fairly specific niche (response parsing tests), so it would not conflict with virtually any skill, matching anchor 3 ('Somewhat specific but could still overlap with similar skills'). It does not reach 4-5 because without trigger phrases or scope markers it could plausibly fire for other API-testing or test-data skills.

3 / 5

Total

9

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

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