CtrlK
BlogDocsLog inGet started
Tessl Logo

a

First skill in the multi-skill fixture repo, used to test fan-out validation.

35

Quality

30%

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 ./test/fixtures/agentskills-repo/skills/a/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%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 vacuous: it contains no executable guidance and its single workflow step is vague. Progressive disclosure is fine only because there is no content to disclose.

Suggestions

Replace 'Do the first thing' with a concrete, executable instruction or code example.

If the skill is genuinely a single action, make that action unambiguous so workflow clarity can reach the simple-skill ceiling.

Confirm whether this fixture SKILL.md is meant to model real content; if so, add the actual task steps.

DimensionReasoningScore

Conciseness

The body ('# Skill A' and '1. Do the first thing.') has zero padding and does not over-explain, but the tokens convey little useful information so it sits just below the fully-earned score-5 anchor; it is noticeably above the verbose lower anchors.

4 / 5

Actionability

'Do the first thing' is entirely vague with no concrete code or commands, matching the score-1 anchor 'Entirely vague or abstract; no concrete code or commands'.

1 / 5

Workflow Clarity

A single numbered step is present but it is poorly defined and vague, matching the score-2 anchor 'Rough sequence present but many gaps; steps poorly defined'; the simple-skill exception does not apply because the single action is not unambiguous.

2 / 5

Progressive Disclosure

The body is under 50 lines, has a single heading and one item, and there are no bundle files to reference, so under the simple-skill exception the minimal but organized structure scores 5.

5 / 5

Total

12

/

20

Passed

Description

17%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 reads as test-fixture metadata rather than a real capability description, with no concrete actions, no natural trigger terms, and no 'when to use' guidance. It scores poorly across every dimension.

Suggestions

Rewrite the description to state concrete actions the skill performs (e.g., 'Processes ... and returns ...') instead of describing it as a fixture.

Add an explicit 'Use when ...' clause with natural trigger phrases a user would actually say.

Include file extensions or synonym terms that distinguish this skill from sibling skills in the repo.

DimensionReasoningScore

Specificity

The phrase 'used to test fan-out validation' names a domain but the action is minimal and generic, matching the score-2 anchor 'Names the domain but actions are minimal or generic'; it does not list concrete actions so it is not a 3.

2 / 5

Completeness

It offers a vague 'what' ('First skill in the multi-skill fixture repo...') and entirely lacks a 'Use when...' trigger, matching the score-2 anchor 'Has a vague what and no when'; the missing-when cap of 3 is not even reached.

2 / 5

Trigger Term Quality

Terms like 'multi-skill fixture repo' and 'fan-out validation' are technical jargon no user would naturally say, matching the score-1 anchor of only technical jargon with no natural keywords.

1 / 5

Distinctiveness Conflict Risk

As a skill description it is very broad with no distinct trigger niche, overlapping conceptually with many skills, matching the score-2 anchor 'Very broad; high overlap risk'.

2 / 5

Total

7

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
saif-shines/doraval
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.