Dotclaude ux

Use when reviewing a user-facing page or flow for usability issues, confusion, friction, or missed UX principles.

install

source · Clone the upstream repo

git clone https://github.com/JHostalek/dotclaude

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/JHostalek/dotclaude "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ux" ~/.claude/skills/jhostalek-dotclaude-ux && rm -rf "$T"

manifest: skills/ux/SKILL.md

source content

page_path = $ARGUMENTS

If page_path provided, focus on that page/component. Otherwise, evaluate entire application UI.

Approach

Match evaluation depth to scope. A single component needs the 2-3 most relevant dimensions, not a 13-dimension sweep. A full page gets all 13. An entire app — focus on the 3 highest-traffic flows first; a full audit produces so many findings that none get fixed.

Gather context through whatever methods are available: live browser navigation (preferred), screenshots, or code review. At least one source is required. Combine multiple for best results.

Apply dimensions from ui-evaluation.md. Score each 1-5.

Output

Scores

Rate each evaluated dimension 1-5 (1=broken, 5=excellent). Compact table. Overall UX score = average.

Findings

Critical (blocks primary task): Issue →

file:line

→ specific fix High (major frustration): Issue → location → fix What Works: Preserve these during fixes Low (polish): Brief list

Validation

For each critical/high fix: what to test (user action) and what success looks like (behavior or outcome).

After presenting: offer to implement top 3 critical/high fixes immediately.