Content
85%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |