CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

screenshot

Use when a rendered visual would help — verifying a change renders, checking code output by eye instead of a test run, capturing a bug repro or a visual for a PR. Drives a real running web app in headless Chromium via a reusable Playwright runner and writes a PNG.

Quality

90%

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

88%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 an exemplary lean, executable guide: concrete driver examples, an exact invoke command, and built-in feedback (console error echo, clipboard verification). The only weaknesses are a redundant opening paragraph that restates the description and a companion runner script that is referenced but absent from the bundle as presented.

Suggestions

Trim the opening paragraph, which restates the frontmatter description's trigger list almost verbatim — one sentence of purpose is enough.

Ship the runner in the bundle (e.g., scripts/screenshot.mjs) and update the invoke path to a bundle-relative location so the sole external reference resolves.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence (e.g., 'You don't edit it — you write a driver and pass it in'), but the opening paragraph restates the frontmatter description's trigger list ('reach for it whenever seeing the rendered result would help... any reason a rendered visual is useful'), which is redundant. Minor over-explanation that could be trimmed fits the 4 anchor; it is not 5 because of that duplication.

4 / 5

Actionability

Fully executable throughout: copy-paste driver examples, the exact invoke command ('node ~/.claude/skills/screenshot/screenshot.mjs ./shot.mjs [outPath]'), working osascript clipboard commands, and variant examples (selector, clip, fullPage) covering the common cases. This matches the copy-paste-ready anchor.

5 / 5

Workflow Clarity

A single-purpose skill with an unambiguous sequence (prerequisites → write driver → invoke → clipboard → cleanup) and real validation checkpoints: page/console errors are echoed to stdout so 'a broken page shows up in the run output', and the clipboard step includes an explicit verification ('Verify it landed — the output should lead with «class PNGf» and a byte count'). The operation is non-destructive, so no validation cap applies.

5 / 5

Progressive Disclosure

Sections are well-organized and the single companion reference (screenshot.mjs) is one level deep with its fixed behavior documented inline. However, the bundle contains no scripts/ directory and no sibling screenshot.mjs, so the skill's sole referenced file cannot be verified to exist — good structure with a minor organization gap fits the 4 anchor rather than 5's 'appropriately split' content.

4 / 5

Total

18

/

20

Passed

Description

88%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 description that explicitly covers both what the skill does and when to use it, with concrete, specific capability statements. Its main gap is that the headline trigger term 'screenshot' is absent, relying instead on paraphrases like 'rendered visual' and 'writes a PNG'.

Suggestions

Include the literal word 'screenshot' (e.g., 'Takes a screenshot of...') so the description matches the term users most naturally say when they need this skill.

Tighten the opening clause 'when a rendered visual would help' to a more distinctive trigger to reduce overlap with run-the-app / visual-checking skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'verifying a change renders', 'checking code output by eye', 'capturing a bug repro or a visual for a PR' — and names the exact mechanism ('Drives a real running web app in headless Chromium via a reusable Playwright runner and writes a PNG'), matching the comprehensive-coverage anchor.

5 / 5

Completeness

Both halves are explicit: 'Use when a rendered visual would help' plus enumerated concrete triggers answers 'when', and the Playwright/Chromium/PNG sentence clearly answers 'what'. This matches the anchor for explicitly answering both with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases like 'verifying a change renders', 'bug repro', and 'visual for a PR' are present, but the most obvious term a user would say — 'screenshot' — never appears in the description. Good coverage with a few natural terms missing fits the 4 anchor; it is above 3 (more than 'some relevant keywords') but short of 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (headless-Chromium screenshot via Playwright, PNG output), but the broad opening 'when a rendered visual would help' and 'verifying a change renders' / 'checking code output by eye' overlap with run-the-app and test-alternative skills, fitting 'mostly distinct; minor overlap risk' rather than minimal conflict.

4 / 5

Total

18

/

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

joshmanders/dotfiles

Path

claude/skills/screenshot/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.