CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

user-testing-validator

Real-surface validation coordinator for engineering validation assignments. Exercises assigned assertions through browser, API, CLI, background, generated-artifact, migration/data, public-library, or parity surfaces and returns per-target verdicts with fresh evidence.

Quality

76%

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 ./.agents/skills/user-testing-validator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-sequenced, mostly lean instruction skill: explicit verdict rules, recovery loops, evidence floors, and a concrete report template make it highly actionable for a process skill. Minor improvements are consolidating the duplicated surface lists and splitting per-surface evidence details into a reference file.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with no explanations of concepts Claude already knows — quotes: "Worker-authored tests, source inspection, and worker screenshots are supporting context only" and "Do not choose a lower-level shortcut merely because it is easier". The main trimmable redundancy is that the eight surfaces are enumerated twice (Surface Selection and Minimum Evidence Floors); that duplication keeps it at anchor 4 ('efficient; minor instances that could be trimmed') rather than 5, and it is well above anchor 3 since nothing reads as padding.

4 / 5

Actionability

For an instruction-only skill the guidance is concrete: exact artifact paths ("<regressions_dir>/<item_id>.md", "<evidence_dir>"), an explicit decision rule ("skipped, missing, or blocked assigned-target results map to passed=false"), a one-recovery policy ("attempt one non-disruptive recovery"), and a full copy-ready report template. Not a 5 because a few directives stay abstract ("Perform the actor workflow from setup to expected result" gives no example of a real exercise) and no concrete sample command or evidence filename is shown; not a 3 because the decision rules, file conventions, and output schema are specific and immediately executable.

4 / 5

Workflow Clarity

The six-step Procedure is clearly sequenced (Prepare setup → Partition lanes → Exercise → Save evidence → Regression ledgers → Synthesize verdicts) with explicit validation checkpoints and a feedback loop: "If setup or a required Needs entry fails, attempt one non-disruptive recovery. If still blocked, fail affected targets with setup evidence", plus the hard checkpoint "Missing required evidence means passed=false" and complete pass/fail mapping rules. This matches anchor 5 (clear sequence, explicit validation, error-recovery feedback, checklists); lane-attribution rules add error handling anchor 5 lacks.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the single file is well-sectioned (Inputs, Surface Selection, Procedure, Minimum Evidence Floors, Report) with no nested references — good structure per anchor 4. It is not a 5 because at ~135 lines some surface-specific detail (per-surface evidence floors) is inlined where a one-level-deep reference file could carry it, and the scoring note's 5-with-sections-only exception applies only to skills under 50 lines.

4 / 5

Total

17

/

20

Passed

Description

58%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 specific and third-person, clearly stating what the skill does and enumerating eight validation surfaces comprehensively. Its main weaknesses are the absence of any 'Use when...' trigger guidance and a vocabulary of internal jargon ('assigned assertions', 'parity surfaces', 'per-target verdicts') that users would not naturally say when they need this skill.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when asked to independently validate or re-test engineering assertions with real user-facing evidence rather than trusting worker-reported results.'

Replace internal jargon ('assigned assertions', 'per-target verdicts', 'parity surfaces') with natural user-facing terms ('verify tests actually pass', 'per-test pass/fail verdicts', 'porting checks').

Include common trigger synonyms such as 'validate', 'verify', 're-test', 'check the tests really pass' so users' natural phrasing matches the description.

DimensionReasoningScore

Specificity

Quotes: "Exercises assigned assertions through browser, API, CLI, background, generated-artifact, migration/data, public-library, or parity surfaces" and "returns per-target verdicts with fresh evidence" — a specific enumeration of eight concrete surfaces plus two well-defined actions. Not a 5 because the core actions reduce to two verbs (exercise, return verdicts) and some phrases ('parity surfaces', 'per-target verdicts') lean on internal jargon rather than plainly stated capabilities; not a 3 because coverage across surfaces is comprehensive rather than 1-2 actions.

4 / 5

Completeness

The 'what' is clear ("Real-surface validation coordinator... Exercises assigned assertions... returns per-target verdicts with fresh evidence"), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3 ('has a clear what but when is missing or only weakly implied'); not a 4 because the when cannot be inferred from the text itself.

3 / 5

Trigger Term Quality

Quotes: "browser, API, CLI" are natural terms a user might say, but "validation assignment", "assigned assertions", "fresh evidence", and "parity surfaces" are workflow-internal jargon users would not naturally utter. It matches anchor 3 ('some relevant keywords but missing common variations or synonyms') — natural phrasings like 'verify', 'test the tests', 'check it actually works', or 'real browser check' are absent; not a 4 because the vocabulary skews heavily orchestration-internal rather than user-natural.

3 / 5

Distinctiveness Conflict Risk

Quotes: "Real-surface validation coordinator for engineering validation assignments" and "per-target verdicts with fresh evidence" carve out a distinct niche (independent validation of worker claims via real surfaces) with minimal overlap risk against general testing or QA skills. Not a 5 because generic trigger words like 'validation' and 'testing' could still pull it into overlap with generic test-writing skills; clearly above anchor 3 since the fresh-evidence/verdict framing is quite specific.

4 / 5

Total

14

/

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

jomi-se/bookhand

Path

.agents/skills/user-testing-validator/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.