ux-heuristics

Evaluate interface usability using Krug's principles and Nielsen's 10 heuristics with severity-rated audit templates.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/trobias/portfolio-nextjs-v2 --skill ux-heuristics-trobias
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ux-heuristics
Source: https://github.com/trobias/portfolio-nextjs-v2/tree/main/.agents/skills/ux-heuristics
Command: npx skills add https://github.com/trobias/portfolio-nextjs-v2 --skill ux-heuristics-trobias

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Interfaces often confuse users through unclear labels, missing feedback, and hidden navigation, and teams lack a structured way to find and prioritize these problems. This Skill provides a systematic heuristic evaluation framework that identifies usability issues, rates their severity, and prescribes concrete fixes. ## Core Features & Use Cases - Heuristic Audits: Apply Krug's laws (Don't Make Me Think, Trunk Test) and Nielsen's 10 heuristics with a 0-4 severity scale and a 10-point scoring system. - Structured Templates: Use the audit checklist, WCAG 2.1 AA checklist, and quick diagnostic table to evaluate any screen consistently. - Specialized References: Resolve heuristic conflicts, recognize dark patterns, and handle cultural/RTL localization concerns. - Use Case: A product team notices users abandoning a checkout form. Run a heuristic evaluation to find that error messages are vague (severity 3) and required fields are unmarked (severity 2), then apply the recommended fixes. ## Quick Start Audit this checkout page for usability issues using Nielsen's heuristics and rate each issue by severity.

Frequently Asked Questions about ux-heuristics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I conduct a heuristic evaluation of a website?▼

Walk through each screen checking against Nielsen's 10 heuristics and Krug's principles, logging every issue with a severity rating from 0 to 4. Use the audit template to capture issues per heuristic, then summarize top issues and quick wins by severity.

What are Nielsen's 10 usability heuristics?▼

They are ten general principles: visibility of system status, match with the real world, user control and freedom, consistency, error prevention, recognition over recall, flexibility and efficiency, minimalist design, error recovery, and help documentation. Each heuristic includes good implementations and common violations.

How do I rate the severity of a usability problem?▼

Rate issues on a 0-4 scale weighing frequency, impact, and persistence: 0 is not a problem, 1 cosmetic, 2 minor, 3 major with significant task failure, and 4 catastrophic blocking task completion. Severity 3-4 issues should be fixed first.

What is the difference between heuristic evaluation and user testing?▼

Heuristic evaluation is an expert review against established principles, taking 1-2 hours and catching major violations before testing. User testing observes real behavior over 2-4 hours and reveals issues experts miss; run heuristics first, then validate with users.

Does this cover accessibility and WCAG compliance?▼

Yes, it includes a complete WCAG 2.1 Level AA checklist covering perceivable, operable, understandable, and robust criteria. It lists contrast ratios, keyboard navigation requirements, screen reader testing with VoiceOver and NVDA, and common failure fixes.

When should I not rely on heuristic evaluation alone?▼

Heuristics miss domain-specific confusion and real user behavior, so they should not replace user testing for critical flows. They also require judgment when heuristics conflict, such as simplicity versus flexibility, which the conflict-resolution framework addresses.