CtrlK
BlogDocsLog inGet started
Tessl Logo

ux-review

Validate a UX spec, HUD design or pattern library — accessibility, GDD alignment, readiness. APPROVED / NOT ASSESSED / NEEDS REVISION / MAJOR REVISION NEEDED.

60

Quality

76%

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 ./.claude/skills/ux-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 well-sequenced, highly actionable review procedure with genuine error-recovery handling for missing inputs — a strong instruction-only skill. Its two weaknesses are the monolithic structure (three per-document-type checklists inlined where only one is ever needed) and a trimmable layer of rationale prose plus one ambiguous verdict-selection rule for mixed findings.

Suggestions

Split Phase 3A/3B/3C checklists into separate reference files (e.g., references/ux-spec-checklist.md, hud-checklist.md, pattern-library-checklist.md) loaded only for the matching document type, cutting per-invocation context by roughly half.

Trim the rationale blockquotes and the NOT ASSESSED ranking justification to bare rules — state what to report and when, without defending why the rule exists.

Add an explicit rule for the mixed case, e.g.: 'If any blocking issue exists, the verdict is NEEDS REVISION or higher regardless of unassessed dimensions; if no issues are found but dimensions are unassessed, the verdict is NOT ASSESSED.'

DimensionReasoningScore

Conciseness

The body is dense operational content — checklists, exact file paths, fallback chains — with no teaching of concepts Claude already knows. However, ~25–30 lines are justificatory prose (the NOT ASSESSED ranking rationale, the accessibility/pattern-library blockquotes explaining why rules exist, and meta-commentary like 'The same rule lives in /team-ui Phase 4 and is mirrored here so the two cannot drift') that could be trimmed to bare rules. Not 5 due to those trimmable passages; not 3 because the padding is minor and everything else earns its tokens.

4 / 5

Actionability

For an instruction-only skill this is highly executable: exact paths (design/ux/hud.md, design/accessibility-requirements.md, project.yaml platform keys with derivation rules), a complete copy-paste output template covering all four verdict branches, and per-argument handling. The one minor gap is verdict selection under mixed findings — the NOT ASSESSED paragraph ranks severity but never states which verdict to emit when blocking issues and unassessed dimensions co-occur. Not 5 because of that ambiguity; not 3 because the rest is fully concrete.

4 / 5

Workflow Clarity

Phases 1–5 are clearly sequenced with explicit error recovery for missing inputs at every step: unreadable spec → NOT ASSESSED, missing platform block → technical-preferences.md fallback, absent accessibility tier → a named NOT ASSESSED report line with a recommendation. The checklists themselves provide the checkpoint structure the top anchor requires, and the skill is read-only so no destructive-operation cap applies.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~330-line body inlines three full checklists (3A/3B/3C) of which only one runs per invocation — the other two (~90 lines) are dead context weight per run. This matches 'content that should be separate is inline' despite good section headers making it navigable; not 4 because nothing is split out, not 2 because headers keep it easy to navigate. Splitting each Phase 3 checklist into a one-level-deep reference file loaded only for the matching document type would materially reduce per-invocation token cost.

3 / 5

Total

16

/

20

Passed

Description

66%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 communicates a clear, distinctive niche with concrete validation targets and verdict levels, but it omits any 'when to use' trigger guidance, which caps its completeness and weakens its usefulness for skill routing. Adding an explicit 'Use when...' clause with natural trigger phrases would lift both completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g.: 'Use after completing a UX spec with /ux-design, before handoff to ui-programmer or art-director, or before the Pre-Production gate check.'

Include natural user phrasings as trigger terms — 'review' or 'check' a UX spec/HUD/pattern library — so the description matches how users actually ask.

State what the skill produces (a read-only review report with APPROVED/NEEDS REVISION verdicts) so the 'what' covers output as well as scope.

DimensionReasoningScore

Specificity

"Validate a UX spec, HUD design or pattern library — accessibility, GDD alignment, readiness" names three concrete document types, three validation dimensions, and four verdict levels. It lists several specific items with only minor coverage gaps (e.g., the report-output nature is unstated), fitting the 'several specific actions; minor gaps' anchor rather than the 1–2-action anchor at 3.

4 / 5

Completeness

The 'what' is clear (validate UX specs, HUD designs, and pattern libraries across accessibility, GDD alignment, readiness), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description — the rubric explicitly caps completeness at 3 for this. It is not 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

Strong domain keywords a user would naturally say — "UX spec", "HUD design", "pattern library", "accessibility" — but common synonyms like "review", "check", or file-name variations are absent, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

Game-dev-specific terms ("HUD design", "pattern library", "GDD alignment") carve a clear niche, but broad words like "accessibility" and "readiness" leave minor overlap risk with a sibling /ux-design skill or a generic accessibility checker. Not 5 because the missing trigger clause does less to sharpen distinct invocation.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
Donchitos/Claude-Code-Game-Studios
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.