CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

design-review

Review a web app or page for visual design quality — layout, typography, spacing, colour, hierarchy, consistency, interaction patterns, and responsive behaviour. Not a UX audit (that checks usability) — this checks whether it looks professional and polished. Produces a design findings report with screenshots. Triggers: 'design review', 'does this look good', 'review the design', 'check the layout', 'is this polished', 'visual review', 'design audit', 'make it look better', 'it looks off'.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

76%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 dense, calibrated checklist skill: concrete numeric criteria throughout, a clear severity taxonomy, and a copy-paste output template. Its weaknesses are the implicit (unnumbered) workflow and the two sections that delegate to 'ux-audit' content that is not bundled here.

Suggestions

Add a short numbered workflow near the top (e.g., 1. Resolve URL, 2. Open in detected browser tool, 3. Screenshot light AND dark mode, 4. Work through the 7 check categories, 5. Assign severities, 6. Write report to .jez/artifacts/design-review.md) so the sequence and the light/dark-mode checkpoint are explicit rather than implied by section order.

Inline the actual browser tool detection and URL resolution steps instead of 'Same as ux-audit — Chrome MCP, Playwright MCP, or playwright-cli', since that sibling skill's content is not part of this bundle and the deflection leaves an execution gap.

State an explicit verification checkpoint that every High finding has a corresponding screenshot attached before the report is written, turning the screenshot instruction into a validating step of the workflow.

DimensionReasoningScore

Conciseness

Every line is a functional check with concrete thresholds ('Body text 50-75 characters per line', '150-200ms ease', '44x44px on mobile', 'WCAG AA (4.5:1 for body)'), not explanation of concepts Claude already knows. The tables, severity guide, output template, and tips all earn their tokens; there is no padding or tutorial-style prose, so no neighbor anchor fits better.

5 / 5

Actionability

The check tables give measurable good/bad criteria, the severity guide is concrete, and the Output section provides a copy-paste-ready report template with an exact path ('.jez/artifacts/design-review.md'). It misses a 5 because 'Browser Tool Detection' and 'URL Resolution' defer entirely to another skill ('Same as ux-audit — Chrome MCP, Playwright MCP, or playwright-cli') without inlining the actual steps, leaving a gap if that skill's content is unavailable.

4 / 5

Workflow Clarity

The operational flow (resolve URL → detect browser tool → run the 7 check categories → assign severity → write the report) is only implicit in section ordering; there is no explicit step sequence or checkpoint (e.g., 'screenshot both light and dark mode before writing findings' exists only as a tip). This matches 'sequence present but checkpoints missing or implicit'; the destructive/batch cap does not apply since this is a read-only review, and a 4 would require an explicit sequence.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the single SKILL.md is well-organized into clear sections with a consistent table format. The 7 check-category tables (~150 lines total) could arguably live in a reference file to slim the main file, which is the minor organization gap separating this from a 5; the under-50-lines simple-skill exception does not apply.

4 / 5

Total

16

/

20

Passed

Description

95%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: concrete scope with enumerated check dimensions, an explicit deliverable, verbatim trigger phrases, and an explicit boundary against UX auditing. The only soft spot is that the capability is expressed as a single review action over many dimensions rather than multiple discrete actions.

DimensionReasoningScore

Specificity

The description enumerates eight concrete review dimensions ('layout, typography, spacing, colour, hierarchy, consistency, interaction patterns, and responsive behaviour') plus a concrete deliverable ('Produces a design findings report with screenshots'), which is several specific capabilities with only minor gaps. It falls short of a 5 because it is effectively one action (review) with many objects rather than multiple distinct concrete actions like 'extract text, fill forms, merge documents'.

4 / 5

Completeness

It explicitly answers 'what' ('Review a web app or page for visual design quality — layout, typography... Produces a design findings report with screenshots') and 'when' ('Triggers: ...' with nine concrete phrases), plus a scope boundary ('Not a UX audit (that checks usability)'). This clearly matches the anchor-5 example structure of what + explicit trigger phrases.

5 / 5

Trigger Term Quality

Nine natural trigger phrases are quoted verbatim: 'design review', 'does this look good', 'review the design', 'check the layout', 'is this polished', 'visual review', 'design audit', 'make it look better', 'it looks off' — covering synonyms ('design review'/'visual review'/'design audit') and exact phrasings a user would naturally say. This comprehensively matches the anchor-5 example's coverage including common variations.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche by explicitly distinguishing from the nearest sibling skill: 'Not a UX audit (that checks usability) — this checks whether it looks professional and polished'. Combined with distinctive triggers like 'is this polished' and 'it looks off', conflict risk with other skills is minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jezweb/claude-skills

Path

plugins/frontend/skills/design-review/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.