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

94%

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

100%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 lean, fully executable runbook: concrete commands for every step, an explicit verification gate before accepting hashes, and tight organization with no wasted tokens. It exemplary balances CI-specific knowledge transfer with actionability.

DimensionReasoningScore

Conciseness

Every section conveys repo-specific facts Claude cannot know (external screenshot service keyed by SHA, hash pinning, Linux-runner byte differences, the three CI surfaces), with the outcome table being the most token-efficient presentation. No padding or explanation of known concepts, matching the lean anchor 5.

5 / 5

Actionability

Copy-paste-ready commands throughout: "gh api repos/microsoft/vscode/actions/jobs/<JOB_ID>/logs", "gh pr checks <PR> --json name,link,bucket", the curl image fetches, the executable python3 PIL diff-bbox snippet, "git diff", and "gh run download". Placeholders are values the skill itself shows how to obtain, and the fork-PR path is covered, matching anchor 5.

5 / 5

Workflow Clarity

A clear 3-step sequence with explicit validation checkpoints: Step 2 is a verification gate ("Confirm the delta matches what the PR intends… treat it as a regression and fix the code instead of the hashes"), Step 3 verifies the edit via git diff ("the exact inverse of the diff CI reported"), and the re-running check closes the feedback loop. The destructive/batch cap does not apply because validation is present, matching anchor 5.

5 / 5

Progressive Disclosure

A single-file skill with no bundle directories; the content is one coherent procedure where splitting would hurt. Sections are well-organized and repo-file references (blocks-ci-screenshots.md, screenshotBlocksCi.ts, the workflow file) are clearly signaled and one level deep, satisfying the simple-skill exception.

5 / 5

Total

20

/

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.

The description clearly states what the skill does and when to use it, with concrete trigger phrases and a highly distinctive niche (blocks-ci screenshot hashes). Trigger-term coverage is strong but could add a few more natural variations.

DimensionReasoningScore

Specificity

"Update the committed blocks-ci screenshot hashes" and "investigate a screenshot diff reported on a PR" are concrete, domain-specific actions in third person voice. It lists several specific actions but coverage is slightly narrow (e.g., render-failure variants covered by the body are absent), fitting anchor 4 rather than the comprehensive anchor 5.

4 / 5

Completeness

What ("Update the committed blocks-ci screenshot hashes… or investigate a screenshot diff") and when ("Use when asked to update, accept, or refresh component screenshot baselines from CI", plus the concrete condition "after the 'Screenshots & Tests' check fails") are both explicitly answered with concrete trigger phrases. Not 4 because the 'when' is fully explicit, not merely present.

5 / 5

Trigger Term Quality

"update, accept, or refresh component screenshot baselines from CI" provides good natural-verb coverage with synonyms, and "blocks-ci" matches what repo users would say. A few natural variations (e.g., "visual regression", the fixture file name) are missing, so it fits anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

"blocks-ci screenshot hashes" and "component screenshot baselines from CI" define a clear niche with distinct triggers, making conflict with other skills minimal. Fits the anchor-5 example's pattern of a specific artifact type plus explicit trigger conditions.

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

microsoft/vscode

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.