CtrlK
BlogDocsLog inGet started
Tessl Logo

enrich-qa-test

Review QA test and capture element screenshots to enrich documentation

59

Quality

47%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/product-design/skills/enrich-qa-test/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 provides a basic understanding of the skill's purpose but is too terse and lacks explicit trigger guidance. It fails to specify when Claude should use this skill and doesn't include enough natural language variations that users might employ when requesting this functionality.

Suggestions

Add an explicit 'Use when...' clause with trigger terms like 'QA testing', 'test screenshots', 'capture UI elements', 'test documentation', 'visual testing'

Expand the capabilities list to be more specific, e.g., 'Captures element screenshots during QA test execution, annotates test results, and embeds visuals into test documentation'

Include file type or tool references users might mention, such as 'Selenium', 'Playwright', 'test reports', or specific image formats

DimensionReasoningScore

Specificity

Names domain (QA test, screenshots, documentation) and some actions (review, capture, enrich), but lacks comprehensive detail about what specific operations are performed or what types of elements/documentation are involved.

2 / 3

Completeness

Describes what it does at a high level but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.

1 / 3

Trigger Term Quality

Contains some relevant keywords like 'QA test', 'screenshots', 'documentation', but missing common variations users might say such as 'testing', 'screen capture', 'docs', 'UI elements', or 'test automation'.

2 / 3

Distinctiveness Conflict Risk

Somewhat specific to QA testing and screenshot capture, but 'documentation' is generic and could overlap with other documentation-related skills. The combination of QA + screenshots provides some distinction.

2 / 3

Total

7

/

12

Passed

Implementation

62%

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

This skill provides a well-structured workflow for enriching QA tests with screenshots, with clear phases and good error handling guidance. However, it's verbose in places, lacks fully executable code examples, and could benefit from splitting detailed reference content into separate files to improve token efficiency.

Suggestions

Replace pseudocode Playwright MCP calls with actual executable examples showing exact tool invocations and parameters

Move the Element Detection Patterns table and detailed Error Handling examples to a separate reference file (e.g., ELEMENT-PATTERNS.md)

Remove the 'Purpose' section as it restates what's already clear from the usage and execution instructions

DimensionReasoningScore

Conciseness

The skill is moderately verbose with some unnecessary explanation. The element detection patterns table and error handling examples add value, but sections like 'Purpose' explain what Claude can infer from the usage and execution instructions.

2 / 3

Actionability

Provides structured guidance with clear phases and steps, but lacks fully executable code. The Playwright MCP calls are shown as pseudocode patterns rather than complete, copy-paste ready implementations.

2 / 3

Workflow Clarity

Excellent multi-phase workflow with clear sequencing (Parse → Capture → Generate → Update). Each phase has numbered steps, and error handling section provides feedback for common failure scenarios.

3 / 3

Progressive Disclosure

References related skills and commands appropriately, but the main document is quite long (200+ lines) with detailed tables and examples that could be split into separate reference files for element patterns and error handling.

2 / 3

Total

9

/

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

Repository
jpoutrin/product-forge
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.