CtrlK
BlogDocsLog inGet started
Tessl Logo

design-qa

Internal prototype QA helper. Use only after a Product Design prototype, URL-to-code build, or image-to-code build has a source visual target and a rendered implementation to compare before handoff. Do not use for broad UX critique, design critique, product audits, or flow reviews; route those user-facing requests to audit.

64

Quality

78%

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 ./packages/opencode/src/skill/builtin/.bundle/product-design/workflows/design-qa/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 strong instruction-only skill body with an exemplary iteration loop, validation gates, and a concrete output contract (report template, design-qa.md schema, passed/blocked rule). The main costs are token efficiency — repeated rules and an inlined fidelity-surface checklist that duplicates the qa-rubric reference — and a couple of high-level deferral steps where an inline example would help.

Suggestions

Conciseness: state the same-image-comparison rule once (either in the Workflow preamble or step 2) and delete the duplicate; drop the restated exclusions in the opening paragraphs since the frontmatter description already carries them.

Progressive disclosure: collapse the 'Required Fidelity Surfaces' section to a short list of the five surface names plus any non-negotiable rule, and move the per-surface detail into references/qa-rubric.md where it is already largely duplicated.

Actionability: add one concrete inline example of an evidence citation (e.g. a filled-in finding line with screenshot path and viewport) so the capture/cite steps are copy-paste executable rather than only described.

DimensionReasoningScore

Conciseness

The body is mostly efficient, dense instructions, but includes notable repetition and padding: the description's exclusions are restated ('Do not use this skill for broad UX critique...'), the same-image-comparison rule appears twice ('Do not pretend separate image views are side-by-side comparison' and again in step 2 as 'Capturing screenshots is not enough...'), and wordy lines like 'It is incredibly important to check fonts carefully for fidelity, including looking up similar typefaces...' could be trimmed. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') — above anchor 2 because there is no tutorial-style explanation of concepts Claude already knows, below anchor 4 because several duplicated passages earn no new information.

3 / 5

Actionability

Concrete, executable guidance throughout: a copy-paste report template with per-finding fields (Location/Evidence/Impact/Fix), an explicit design-qa.md contents checklist, exact severity definitions P0–P3, and a hard binary gate ('final result must be exactly passed or blocked'). Anchor 5 is not fully met because a few steps stay high-level — e.g. 'use design context and screenshot tools when available' and 'follow the Browser Choice rule' defer specifics without inline examples — so anchor 4 ('mostly executable guidance... minor gaps') is the closest fit.

4 / 5

Workflow Clarity

The six-step workflow is clearly sequenced with an explicit feedback loop (record finding → apply fix → recapture at same viewport/state → recompare), a blocked/pass gating rule, and validation checkpoints ('If either artifact cannot be opened... write design-qa.md with final result: blocked'; 'Do not say a design matches... until the required fidelity surfaces have been checked'). This matches anchor 5: clear sequence, explicit validation, feedback loops, and a final checklist.

5 / 5

Progressive Disclosure

Structure is good: the deep checklists live in the real, one-level-deep references/qa-rubric.md, which is clearly signaled ('Read qa-rubric when the QA pass spans more than a quick visual check'), and cross-skill pointers (audit, critical-overrides, index#browser-choice) are linked inline. It falls short of anchor 5 because the 'Required Fidelity Surfaces' section inlines detailed per-surface checklists (fonts, colors, imagery, including the long fail-QA asset-substitution rule) that substantially duplicate references/qa-rubric.md content and could largely live in the reference file.

4 / 5

Total

16

/

20

Passed

Description

82%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 well-scoped description that clearly answers both what and when, with strong explicit de-confliction against the adjacent audit skill. Its main weakness is capability specificity — it describes one comparison action rather than a fuller set of concrete actions, and omits some natural trigger synonyms (Figma, mockup, screenshot).

DimensionReasoningScore

Specificity

The description names the domain ('Internal prototype QA helper') and one concrete action — comparing 'a source visual target and a rendered implementation... before handoff' — but does not enumerate several specific actions the way the 4–5 anchors expect. It is more context-routing than a list of capabilities, and anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') is the closest fit; it is above anchor 2 because the compare-before-handoff action is concrete, but below anchor 4 because no additional concrete actions (reporting, fix list, severity rating) are stated.

3 / 5

Completeness

Both halves are explicit: the what ('compare a source visual target and a rendered implementation... before handoff') and the when ('Use only after a Product Design prototype, URL-to-code build, or image-to-code build...'), plus an explicit when-not clause. This matches anchor 5's 'clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

Good keyword coverage of the domain's natural terms: 'prototype QA', 'Product Design prototype', 'URL-to-code build', 'image-to-code build', 'design', 'handoff', plus routing terms 'UX critique', 'design critique', 'product audits', 'flow reviews', 'audit'. It is below anchor 5 because common synonyms a user might say — 'Figma', 'mockup', 'screenshot', 'visual comparison', 'design review' — are absent, but well above anchor 3's thin coverage.

4 / 5

Distinctiveness Conflict Risk

The skill has a clear niche (internal pre-handoff design QA) with active de-confliction: 'Do not use for broad UX critique, design critique, product audits, or flow reviews; route those user-facing requests to audit'. This is stronger than anchor 4's 'minor overlap risk' — conflicts with adjacent skills are explicitly resolved, matching anchor 5.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository
XiaomiMiMo/MiMo-Code
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.