CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skills-sdk-scenario-quality-fixture

Fixture skill with promotable eval scenario metadata.

Quality

43%

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 ./Infrastructure/tests/fixtures/skills_sdk/scenario_quality_skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

37%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 maximally lean but substantively empty: it states the fixture's purpose in one sentence and provides no instructions, workflow, or navigation. As a deliberate test fixture this may be intentional, but scored as a skill it fails actionability and workflow clarity entirely. Only conciseness earns top marks.

Suggestions

Add at least one concrete, executable instruction or example (e.g. how the scenario-quality receipt in references/evals.yaml is meant to be exercised or interpreted).

If multi-step behavior is intended, enumerate the steps in order with an explicit validation checkpoint.

Link the existing references/evals.yaml from the body (e.g. a short '## Eval scenarios' section pointing to it) so the bundle file is discoverable.

DimensionReasoningScore

Conciseness

The body is exactly two lines — a title and "This fixture exists for Skills SDK scenario-quality receipt tests." — with zero padding and no explanation of concepts Claude already knows, matching anchor 5 ('Lean and efficient; every token earns its place'). Nothing can be trimmed, so scores below 5 do not apply.

5 / 5

Actionability

"This fixture exists for Skills SDK scenario-quality receipt tests." only describes the file's purpose — there is no code, command, or instruction of any kind, matching anchor 1 ('Entirely vague or abstract; only describes rather than instructs'). It is below score 2 because even that anchor's high-level hints ('Import pdfplumber and use it to open the PDF') are absent here.

1 / 5

Workflow Clarity

No steps or sequence exist anywhere in the body — nothing to sequence or validate, matching anchor 1 ('Steps missing or incoherent; no sequence'). The simple-skill exception cannot rescue it: a single action scoring 5 requires that action to be unambiguous, and the body specifies no action at all.

1 / 5

Progressive Disclosure

The body has minimal structure (a single H1, no sections) and the bundle contains references/evals.yaml that is never referenced or signaled from the body, matching anchor 3 ('Some structure but could be better organized; references present but not clearly signaled'). It is below score 4 because that anchor requires references to be mostly clearly linked, and below the under-50-line 5 because there are no well-organized sections and an orphaned bundle file.

3 / 5

Total

10

/

20

Passed

Description

21%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 names a specific but purely internal domain and gives no capabilities, no natural trigger terms, and no usage guidance. It reads as a package label rather than a skill description. Scores are dragged down mainly by the absence of any action statement and any 'Use when' clause.

Suggestions

State 1-3 concrete actions the skill performs in third person (e.g. what it validates, generates, or reports for scenario-quality receipts).

Add an explicit 'Use when...' clause naming the natural phrases a maintainer would say when they need this skill (e.g. scenario quality, eval receipts, promotion evidence).

Include the natural trigger vocabulary (skill, eval, scenario, receipt, evidence) so the description is distinguishable from generic fixture/test skills.

DimensionReasoningScore

Specificity

"Fixture skill with promotable eval scenario metadata" names a concrete domain (fixture, eval scenario metadata) but contains no action verbs whatsoever — it states identity, not capability, matching anchor 2 ('Names the domain but actions are minimal or generic'). It is above score 1 because the domain is specific rather than pure abstraction like 'Helps with documents', but below score 3 because unlike 'Processes PDF files and extracts content' it lists no concrete actions at all.

2 / 5

Completeness

The 'what' is vague — "Fixture skill with promotable eval scenario metadata" describes what the artifact is, not what it does — and there is no 'when' or equivalent trigger guidance, matching anchor 2 ('Has a vague what and no when'). It is below score 3 because that anchor requires a clear 'what' (a concrete capability), and the missing 'Use when...' clause caps completeness at 3 regardless.

2 / 5

Trigger Term Quality

There are no natural keywords a user would say when needing this skill; "promotable eval scenario metadata" and "Fixture skill" are internal technical jargon, matching anchor 1 ('No natural keywords; only technical jargon', e.g. 'Handles document object model manipulation'). It cannot be score 2 because even the generic natural phrases of that anchor ('Works with files') are absent.

1 / 5

Distinctiveness Conflict Risk

The niche (Skills SDK scenario-quality fixtures) is somewhat distinct, but with no actions or triggers the description could overlap with other test/fixture/eval skills, matching anchor 3 ('Somewhat specific but could still overlap with similar skills'). It is below score 4 because 'Works with PDF and Word document files' distinguishes via concrete artifacts, whereas nothing here differentiates it at trigger time.

3 / 5

Total

8

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jscraik/Agent-Skills

Path

Infrastructure/tests/fixtures/skills_sdk/scenario_quality_skill/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.