CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

update-screenshots

Update the committed blocks-ci screenshot hashes after the "Screenshots & Tests" check fails, or investigate a screenshot diff reported on a PR. Use when asked to update, accept, or refresh component screenshot baselines from CI. This skill should be run as a subagent.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

An excellent, lean operational skill: every step is executable with copy-paste commands, validation checkpoints are explicit with recovery paths, and all content is non-obvious repo-specific knowledge rather than concepts Claude already has. Progressive disclosure is solid but entirely inline given the single-file layout.

DimensionReasoningScore

Conciseness

Lean and operational throughout — it assumes Claude knows git/gh/curl and spends tokens only on non-obvious repo facts ("Rendering on macOS or Windows yields different bytes", "compared byte-for-byte"). The Step 2 rationale sentence ("accepting new hashes without looking at the images defeats its purpose") justifies the mandatory verification rather than padding, so anchor 5 holds.

5 / 5

Actionability

Fully executable, copy-paste-ready commands at every step — `gh api repos/microsoft/vscode/actions/jobs/<JOB_ID>/logs`, `gh pr checks <PR> --json name,link,bucket --jq ...`, the curl old/new hash fetches, the PIL diff-bbox snippet, and `git diff test/componentFixtures/blocks-ci-screenshots.md` — with clearly marked dynamic placeholders covering the common surfaces (PR comment, job summary, job log).

5 / 5

Workflow Clarity

Clear Steps 1–3 with explicit validation checkpoints: verify intent via old/new image comparison and diff bbox before accepting, and confirm the edit "is the exact inverse of the diff CI reported" via git diff. Feedback loops for error recovery are present ("treat it as a regression and fix the code instead of the hashes"; CI re-runs after push), and related failure modes are addressed, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

Well-organized single-file skill: the core Steps 1–3 are front-loaded and auxiliary deeper-dive sections ("Investigating further", "Related failures from the same job") come after. Not anchor 5 — the body is ~99 lines with everything inline and no separate reference files, and the under-50-line simple-skill exception does not apply; the split is good but could be made more explicit if the skill grows.

4 / 5

Total

19

/

20

Passed

Description

87%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 strong, niche-specific description that explicitly states both what it does and when to use it, with concrete trigger phrases and synonym coverage in third-person voice. Minor gaps in action coverage and natural-term variations keep it just short of perfect.

DimensionReasoningScore

Specificity

Names two concrete actions — "Update the committed blocks-ci screenshot hashes" and "investigate a screenshot diff reported on a PR" — tied to specific artifacts and triggers. Not anchor 5 because coverage stops there (e.g., triaging related render/test failures from the same check is absent), fitting "several specific actions; minor gaps in coverage".

4 / 5

Completeness

Explicitly answers both: what — "Update the committed blocks-ci screenshot hashes... or investigate a screenshot diff reported on a PR" — and when — a concrete "Use when asked to update, accept, or refresh component screenshot baselines from CI" clause. Both are explicit and specific, matching anchor 5.

5 / 5

Trigger Term Quality

"Use when asked to update, accept, or refresh component screenshot baselines from CI" supplies good natural-term coverage with synonyms (update/accept/refresh). A few natural variations are missing (e.g., "approve screenshots", "fix the failing screenshots check"), which matches anchor 4 rather than comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

Anchored to a niche no generic skill would claim — "blocks-ci screenshot hashes", "Screenshots & Tests check", "component screenshot baselines from CI" — with distinct triggers and minimal conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

posit-dev/positron

Path

.github/skills/update-screenshots/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.