CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/visual-baseline-gate

Use when visual diffs are already classified and CI needs one binding go/no-go: blocks on regressions or on intended baseline changes without sign-off from a reviewer who is not the author, fails closed when the classifier did not run, and writes visual-gate.json and .md.

Quality

91%

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

Overview
Quality
Evals
Security
Files

Quality

Content

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

A well-structured, highly actionable skill body: executable decision logic, explicit fail-closed and escalation semantics, and a clean one-level reference split for CI wiring. The only refinements are tightening the worked example's overlap with the rule and making the self-approval bash check genuinely runnable.

DimensionReasoningScore

Conciseness

The body is efficient and assumes domain competence - engine exit-code semantics ("Chromatic ... exit code `1` = `BUILD_HAS_CHANGES`") are non-obvious and load-bearing rather than padding - but the worked example partially restates the decision rule and the Overview motivation could be tightened slightly. It sits above anchor 3 (no significant unnecessary explanation) but short of anchor 5's every-token-earns-its-place bar.

4 / 5

Actionability

The `visual_gate` Python function is executable and copy-paste ready, and both input formats are given as concrete schemas, but the author-cannot-self-approve bash snippet contains the placeholder `'.author.login + "@..."'` that cannot run as written - a minor gap that keeps it below the fully-executable anchor.

4 / 5

Workflow Clarity

The six-step emit sequence is explicit with validation checkpoints throughout: fail closed on a missing classifier run, verdict precedence (BLOCK > REVIEW > OK), escalation to BLOCK on self-approval, and a concrete error-recovery loop ("a non-author reviewer either fixes the regression or ... adds both snapshots to .visual-acceptance.yml and re-runs the gate"). This matches the anchor for clear sequencing with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

The SKILL.md keeps the decision rule and worked example inline while consistently delegating artifact templates, the runnable CI script, and GitHub Actions wiring to the existing, verified one-level-deep reference `references/artifact-and-ci-wiring.md`, signaled with clear links at each point of need. Content is appropriately split and navigation is easy.

5 / 5

Total

18

/

20

Passed

Description

92%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 dense, high-signal description that explicitly covers what the gate does, when to use it, and how it differs from adjacent skills, with only minor keyword-coverage gaps. Its one weakness is omitting the natural synonyms ("visual regression", "snapshots", engine names) users might use when asking for a CI gate on visual changes.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions - "blocks on regressions", "blocks ... on intended baseline changes without sign-off from a reviewer who is not the author", "fails closed when the classifier did not run", and "writes visual-gate.json and .md" - giving comprehensive, behavior-level coverage rather than vague capability claims.

5 / 5

Completeness

It explicitly answers both questions: "Use when visual diffs are already classified and CI needs one binding go/no-go" states the trigger concretely, and the action list states exactly what the skill does. The explicit "Use when" clause is present, and its specificity puts it above the anchor where the "when" could be more explicit.

5 / 5

Trigger Term Quality

Good natural keyword coverage ("visual diffs", "CI", "go/no-go", "regressions", "baseline changes", "sign-off"), but common variations a user might say - "visual regression", "snapshots", engine names like Chromatic/Percy/Playwright - are absent, matching the anchor of good coverage with a few natural terms missing rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"visual diffs are already classified" cleanly separates this gate from the upstream classifier skill, and the reviewer-sign-off requirement carves out a clear niche with distinct triggers, so conflict risk with sibling visual-regression skills is minimal.

5 / 5

Total

19

/

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.

Reviewed

On this page