CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agentskills-good

Extracts examples for testing the agentskills.io spec validator. Use when validating a well-formed skill against the open spec.

Quality

68%

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/skills/agentskills-good/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

47%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 concise but nearly empty of substance: the three steps are placeholders with no executable guidance, and the single reference points to a file containing only 'More detail goes here.'. Structure and token efficiency are fine; the skill fails on actionability and workflow definition.

Suggestions

Replace the placeholder steps with concrete, executable instructions — specify the input source, the exact processing actions, and the expected output format for 'Read the input / Process it / Report the result'.

Define what 'Process it' entails step-by-step and add an explicit validation checkpoint (e.g., how to recognize and handle a malformed input) so the sequence survives failure, addressing the workflow_clarity gap.

Either populate references/REFERENCE.md with the real detail the link promises or remove the link — it currently navigates to an empty stub, which undermines the otherwise good progressive-disclosure structure.

DimensionReasoningScore

Conciseness

The body is 7 lines with zero padding: a heading, a three-item list, and one link. Every token earns its place and no concepts are over-explained, matching anchor 5's 'lean and efficient; assumes Claude's competence'.

5 / 5

Actionability

The steps '1. Read the input. 2. Process it. 3. Report the result.' contain no concrete code, commands, or specifics — they describe rather than instruct, and the sole linked file is a placeholder ('More detail goes here.'). This matches anchor 1's 'entirely vague or abstract; no concrete code or commands'; anchor 2 would require at least a high-level hint about what processing entails.

1 / 5

Workflow Clarity

A rough numbered sequence is present, but the steps are undefined ('Process it' specifies nothing) and there is no validation checkpoint, closely matching anchor 2's example '1. Open the document / 2. Make changes / 3. Save and close'. It is below anchor 3 because the problem is not merely missing checkpoints — the step definitions themselves are empty.

2 / 5

Progressive Disclosure

For a sub-50-line skill the structure is appropriate: a heading, a compact step list, and one clearly signaled one-level-deep reference (references/REFERENCE.md) that exists in the bundle. It falls short of anchor 5 because the reference navigates to an empty stub and the body has no real sections organizing content, though it exceeds anchor 3 since the reference is clearly signaled and nothing that belongs elsewhere is inlined.

4 / 5

Total

12

/

20

Passed

Description

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

A well-formed description: third-person voice, an explicit 'Use when' trigger clause, and a distinctive niche with minimal conflict risk. Its main weakness is that the 'what' is thin — 'extracts examples' names only one abstract action without saying what examples or from where — and trigger-term coverage lacks synonyms.

DimensionReasoningScore

Specificity

Names the domain ('agentskills.io spec validator') and one concrete action ('Extracts examples for testing'), but coverage is not comprehensive — it does not say what kind of examples or where they come from. This matches the anchor for 1-2 concrete actions without comprehensive coverage, and falls short of anchor 4's 'several specific actions'.

3 / 5

Completeness

Both parts are explicitly present: a 'what' ('Extracts examples for testing the agentskills.io spec validator') and a 'when' ('Use when validating a well-formed skill against the open spec'). The 'when' is explicit but single-condition, and the 'what' is somewhat abstract (no concrete trigger phrases for what the examples are), which keeps it at anchor 4 rather than 5.

4 / 5

Trigger Term Quality

The 'Use when' clause supplies good natural keywords for the niche — 'validating', 'well-formed skill', 'spec', 'agentskills.io' — which a user in this domain would plausibly say. A few natural variations are missing (e.g., 'lint', 'schema check', 'spec-compliant'), so it does not reach anchor 5's comprehensive synonym coverage, but it is noticeably above anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

'agentskills.io spec validator' defines a clear niche with highly distinct triggers; virtually no other skill would fire on this description. It matches anchor 5's 'clear niche with distinct triggers; minimal conflict risk' and exceeds anchor 4, which reserves for overlap risk with closely related skills.

5 / 5

Total

16

/

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

saif-shines/doraval

Path

test/fixtures/skills/agentskills-good/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.