CtrlK
BlogDocsLog inGet started
Tessl Logo

take-doc-screenshots

Take screenshots of the running pgconsole app for documentation. Use when updating docs with screenshots or adding images to .mdx files.

Install with Tessl CLI

npx tessl i github:pgplex/pgconsole --skill take-doc-screenshots
What are skills?

89

Does it follow best practices?

Validation for skill structure

SKILL.md
Review
Evals

Discovery

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid, focused skill description that clearly defines its purpose and when to use it. The main weakness is limited specificity in actions and trigger terms - it could benefit from listing more concrete capabilities and natural keyword variations users might say.

Suggestions

Expand specific actions beyond 'take screenshots' - e.g., 'capture UI states, save to assets folder, generate markdown image references'

Add more natural trigger terms like 'screen capture', 'UI images', 'visual docs', or 'capture pgconsole'

DimensionReasoningScore

Specificity

Names the domain (pgconsole app screenshots) and one action (take screenshots), but doesn't list multiple concrete actions like 'capture UI states, annotate images, resize for documentation'.

2 / 3

Completeness

Clearly answers both what ('Take screenshots of the running pgconsole app for documentation') and when ('Use when updating docs with screenshots or adding images to .mdx files') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes relevant terms like 'screenshots', 'docs', '.mdx files', and 'documentation', but misses common variations like 'screen capture', 'images', 'UI capture', or 'visual documentation'.

2 / 3

Distinctiveness Conflict Risk

Highly specific to 'pgconsole app' screenshots and '.mdx files' - this narrow scope makes it very unlikely to conflict with other skills like general screenshot tools or documentation skills.

3 / 3

Total

10

/

12

Passed

Implementation

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is an excellent skill file that provides comprehensive, actionable guidance for a specific task. It efficiently covers authentication setup, Playwright scripting patterns, UI-specific interactions (CodeMirror), and image processing conventions without any unnecessary explanation. The workflow is clear and the content is well-structured for the task complexity.

DimensionReasoningScore

Conciseness

Every section is lean and purposeful. No explanation of what screenshots are or why documentation needs images. Assumes Claude knows Playwright, curl, and shell commands.

3 / 3

Actionability

Provides complete, executable commands and code snippets throughout. The curl command, JSON structure, cwebp conversion, and Playwright patterns are all copy-paste ready with specific selectors and keyboard shortcuts.

3 / 3

Workflow Clarity

Clear multi-step sequence from prerequisites through authentication, screenshot capture, and image processing. Each phase has explicit steps, and the overlay dismissal section provides error prevention guidance.

3 / 3

Progressive Disclosure

Well-organized with clear section headers. Content is appropriately scoped for a single SKILL.md file—not too long to need external references, but logically grouped into prerequisites, auth, capture, and processing phases.

3 / 3

Total

12

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

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.