CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ux-review

Reviews UI code (Slim/HTML, CSS, Stimulus/JS) for usability problems against Nielsen's 10 usability heuristics and the Laws of UX, and reports them as a ranked issue log with evidence and fixes. Use when asked for a UX review, UI review, usability audit, heuristic evaluation, or "is this usable", when checking a new screen or flow before it ships, or when the user mentions Nielsen, heuristics, Fitts's Law, Hick's Law, or another Law of UX.

79

Quality

99%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%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.

The body is a model skill document: it assumes Claude already knows the heuristics and spends its entire budget on procedure, stack-specific failure signals, severity definitions, and a concrete report template with an evidence requirement. The workflow is clearly sequenced with a verifiable-evidence checkpoint, and the single-file structure is the right shape for a procedure of this size. No changes needed.

DimensionReasoningScore

Conciseness

"You already know Nielsen's 10 heuristics and the Laws of UX. This skill sets the procedure, what to look for in this stack, and the report format" explicitly declines to re-teach known concepts, and the 13-row checks table carries dense, stack-specific signal with no padding. Every section (Scope, checks, Severity, Report format, Writing the fix) earns its tokens, matching the lean anchor-5 profile.

5 / 5

Actionability

Each check names the exact code that reveals it — "data-turbo-submits-with", "aria-busy", "type, required, min/max, inputmode", "44×44px", "more than about 7 top-level items" — and the report format is a copy-paste markdown template with severity counts, per-finding fields, and a fix-order section. Per the rubric's instruction-only note, the absence of executable code is not penalized when the guidance is this concrete; this is fully actionable, matching anchor 5.

5 / 5

Workflow Clarity

The sections form a coherent sequence — determine scope ("Ask for, or infer, what to review"), read templates/partials/controllers/CSS, run the app if a browser tool exists, work through the check table, dedupe root causes ("file it as one finding"), rate severity, report, then fix — with an explicit verification gate ("Every finding needs a file and line, or the exact screen and element. Drop findings you can't point at") and a literal checklist. The destructive/batch cap does not apply since this is a read-only review, so anchor 5 fits.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and none are needed: this is a single ~70-line procedure whose checks table is appropriately inline at this size. Sections are well-organized and the cross-skill pointers (optics-context, bem-structure) are clearly signaled in parentheses. Per the rubric's simple-skill note, a self-contained skill with well-organized sections and no need for external references scores 5.

5 / 5

Total

20

/

20

Passed

Description

100%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.

The description is exemplary: it states the input types, the evaluation frameworks, the deliverable, and an explicit 'Use when' clause with a comprehensive set of natural trigger terms including synonyms and framework names. Both the what and the when are concrete, and the triggers are unlikely to fire for the wrong skill. No changes needed.

DimensionReasoningScore

Specificity

The description names the input stack ("Reviews UI code (Slim/HTML, CSS, Stimulus/JS)"), the evaluation frameworks ("Nielsen's 10 usability heuristics and the Laws of UX"), and the output artifact ("a ranked issue log with evidence and fixes"). It lists multiple concrete actions with comprehensive coverage of what the skill does, matching the anchor-5 example's completeness rather than the minor-gaps profile of anchor 4.

5 / 5

Completeness

Both halves are explicit: what ("Reviews UI code... and reports them as a ranked issue log with evidence and fixes") and when ("Use when asked for a UX review, UI review, usability audit... or when the user mentions Nielsen, heuristics, Fitts's Law, Hick's Law"). This mirrors the anchor-5 example's structure of concrete what plus concrete trigger phrases, and the 'Use when' clause is present, so no cap applies.

5 / 5

Trigger Term Quality

It covers natural user phrasings and their synonyms — "UX review, UI review, usability audit, heuristic evaluation, 'is this usable'" — plus the framework names a user would drop ("Nielsen, heuristics, Fitts's Law, Hick's Law, or another Law of UX") and a timing trigger ("checking a new screen or flow before it ships"). Coverage including synonyms matches anchor 5.

5 / 5

Distinctiveness Conflict Risk

The niche is a usability heuristic evaluation of a specific UI stack, and the triggers (Nielsen heuristics, Laws of UX, "is this usable", pre-ship screen check) are distinct from generic code-review or CSS-review requests. It presents a clear niche with minimal conflict risk, matching anchor 5.

5 / 5

Total

20

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

RoleModel/rolemodel-skills

Path

skills/ux-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.