CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

screenshots

Generate marketing screenshots of your app using Playwright. Use when the user wants to create screenshots for Product Hunt, social media, landing pages, or documentation.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/screenshots/SKILL.md

The canonical home for this skill is screenshots in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 highly actionable, well-sequenced skill: complete executable Playwright code, smart login handling, verification, and error-recovery guidance. Its weaknesses are redundancy (a duplicated 'When to Use' section and tips that restate earlier steps) and its monolithic structure — a large inline script template with no reference files where that material belongs.

Suggestions

Delete the 'When to Use This Skill' section (it duplicates the frontmatter description) and fold each 'Tips for Best Results' item into the step it belongs to, removing the duplicated guidance.

Move the ~100-line script template into a scripts/ file (e.g., scripts/capture.mjs) and Step 7's advanced options into a references/ file, keeping SKILL.md a lean overview.

Replace the undefined '$1' reference with explicit guidance on how the app URL is obtained, and add a checkpoint in Step 9 to visually inspect one screenshot to confirm it captured the intended UI state.

DimensionReasoningScore

Conciseness

Mostly concrete, but padding is present: the 'When to Use This Skill' section restates the frontmatter description verbatim, 'Tips for Best Results' repeats guidance already given in Steps 6-7 ('waitForLoadState', 'Consistent sizing... same viewport', 'Dark mode variants'), and Step 7's snippets overlap the script template's action handling. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than anchor 4, and it is not anchor 2 because nearly all content is actionable rather than explanatory filler.

3 / 5

Actionability

The body provides a complete Node.js Playwright script with exact viewport/deviceScaleFactor settings, smart login locators, runnable bash commands, and a concrete framework routing table. It stops short of anchor 5 because the template uses placeholders ('[APP_URL]', '[true|false]') that must be substituted before it runs, but it is far above anchor 3 since the code is real and executable once filled.

4 / 5

Workflow Clarity

Nine clearly sequenced steps with an explicit verification step (Step 9: 'ls -la screenshots/*.png' / resolution check) and an Error Handling section with recovery loops ('If login fails, analyze the login page HTML to find the correct selectors and customize the script'). Minor gaps hold it below anchor 5: '$1' is undefined in a skill (slash-command) context, and verification only checks file existence/dimensions without confirming the images captured the intended UI.

4 / 5

Progressive Disclosure

This is a single ~400-line file with no bundle files; the ~100-line script template and Step 7's advanced options are inlined content that would live better in scripts/ or references/ files. Section headers give it decent structure (above anchor 2), but 'content that should be separate is inline' matches anchor 3, and it lacks the split structure of anchor 4.

3 / 5

Total

14

/

20

Passed

Description

78%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: it explicitly states what the skill does and when to use it, in third person, with natural trigger phrases and a distinct marketing-screenshot niche. Its only real limitation is that it names a single action rather than the skill's full concrete capabilities.

Suggestions

Add 1-2 more concrete actions drawn from the body, e.g. 'Captures at true 2x retina resolution, handles login flows, and captures full pages or specific elements' to raise specificity.

Add one or two natural synonyms such as 'screen capture' or 'app preview images' to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names one concrete action — 'Generate marketing screenshots of your app using Playwright' — plus the domain and tool. It does not list the several distinct capabilities the skill actually has (2x retina capture, login handling, element/full-page shots), so it matches 'names domain and 1-2 concrete actions' (3) rather than anchor 4's 'lists several specific actions'; it is above anchor 2 because a real concrete action is stated.

3 / 5

Completeness

It explicitly answers what ('Generate marketing screenshots of your app using Playwright') and when ('Use when the user wants to create screenshots for Product Hunt, social media, landing pages, or documentation') with concrete trigger phrases — a direct match to the anchor 5 example pattern, and clearly above anchor 4 where the 'when' is less specific.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are well covered: 'screenshots for Product Hunt, social media, landing pages, or documentation'. A few natural terms/synonyms are missing (e.g., 'screen capture', 'app preview images'), which fits anchor 4's 'good keyword coverage; a few natural terms missing' rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Marketing screenshots' 'using Playwright' carves a mostly distinct niche with specific triggers like 'Product Hunt'. Minor overlap risk remains: the generic 'screenshots' and 'documentation' triggers could fire for general screenshot or documentation-image skills, fitting anchor 4 ('mostly distinct; minor overlap risk') rather than anchor 5's minimal-conflict niche.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/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.