Review QA test and capture element screenshots to enrich documentation
59
47%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/product-design/skills/enrich-qa-test/SKILL.mdQuality
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
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
0ebe7ae
Table of Contents
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.