heuristic

Featured

Produce a scored heuristic critique of the UI using Nielsen's 10 + 6 design laws + optional persona walkthroughs. Outputs a machine-parseable scorecard plus a 0-100 UsabilityScore (the judged companion to the deterministic UICraftScore). Invoke when the user asks for heuristic on their UI, or mentions 'heuristic' alongside design / UI / frontend work.

Web & Frontend 324 stars 18 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 87/100

Stars 20%
84
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

<!-- HARNESS MIRROR — do not edit here. Canonical source: skills/ or commands/. After editing source, copy into cli/assets/<harness>/ and repo-root harness mirrors. --> **Context:** this sub-skill is one lens of the broader `ui-craft` skill. If the `ui-craft` skill is also installed, read its SKILL.md first for Discovery + Anti-Slop + Craft Test, then apply the specific lens below. Score the UI at `$ARGUMENTS` against Nielsen's 10 + 6 design laws. Load the `ui-craft` skill. **Step 1 — Load the methodology.** Read `references/heuristics.md` for the full rubric, scoring definitions, design law details, and the required output format. Do NOT invent a new format or a new scale. **Step 2 — Walk Nielsen's 10 heuristics.** Score each 1-5 per the rubric: - **1** blocks users · **2** severe friction · **3** works but confusing · **4** works, minor polish · **5** best-in-class For every heuristic, write a concrete finding — quote text, count elements, name the broken flow. Vague findings are rejected. **Step 3 — Audit the 6 design laws.** PASS / FAIL each with a specific detail: - Fitts's Law — touch target sizing, CTA placement - Hick's Law — choice density, nav + select sizing - Doherty Threshold — perceived latency, optimistic UI - Cleveland-McGill — chart encoding choice - Miller's Law — nav depth, form section counts - Tesler's Law — where complexity lives **Step 4 — Persona walkthrough (if `--persona=` present).** If the args include `--persona=<name>`, load `references/pe...

Details

Author
educlopez
Repository
educlopez/ui-craft
Created
5 months ago
Last Updated
1 weeks ago
Language
JavaScript
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category