design-usability-rules

Audit interfaces against Nielsen Norman usability heuristics and accessibility rules.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/coreyone/software-maestro --skill design-usability-rules-coreyone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-usability-rules
Source: https://github.com/coreyone/software-maestro/tree/main/design/evaluation-and-quality/design-usability-rules
Command: npx skills add https://github.com/coreyone/software-maestro --skill design-usability-rules-coreyone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Interfaces often ship with hidden usability defects—low contrast text, skipped heading levels, broken images, confusing forms, and poor error recovery—that frustrate users and fail accessibility standards. This Skill provides a structured heuristic audit framework to detect and fix these issues systematically. ## Core Features & Use Cases - Heuristic Evaluation: Applies Nielsen Norman's 10 usability heuristics, Norman's interaction principles, and Gestalt visual principles to any interface. - Anti-Pattern Detection: Enforces concrete invariants such as WCAG AA contrast ratios (4.5:1 body text), minimum font sizes (11px UI, 14px body), sequential heading hierarchy, and visible-at-rest content. - Form & Checkout Audits: Covers validation timing, error message quality, button hierarchy, guest checkout, and mobile touch targets (44x44px). - Use Case: Ask the agent to audit a multi-step checkout form; it returns a checklist of violations (e.g., premature inline validation, wiped fields on error, undersized labels) with concrete fixes and evidence. ## Quick Start Audit my checkout form for usability issues using Nielsen heuristics and list every violation with a recommended fix.

Frequently Asked Questions about design-usability-rules

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

FAQPage Schema
How do I run a heuristic usability evaluation on a web form?▼

Apply Nielsen's heuristics field by field: check for persistent labels above inputs, inline validation on blur, specific error messages with fix examples, and preserved user input after errors. The audit produces a checklist of violations with concrete remediation steps.

What are the WCAG AA contrast ratio requirements for text?▼

WCAG AA requires a minimum contrast ratio of 4.5:1 for body text and 3.0:1 for large text (18pt or larger, or 14pt bold). Contrast must be evaluated across all background surfaces, gradients, and interactive hover and focus states.

What is the minimum font size for UI text and body copy?▼

Interactive or data-bearing text such as buttons, labels, and table cells must be at least 11px. Body paragraphs should be at least 14px, with 16px preferred for sustained reading on high-DPI and mobile displays.

When should inline form validation fire?▼

Validate on blur when the user leaves a field for format constraints, and on submit for cross-field logic. Never show errors while the user is mid-entry unless the input is unquestionably wrong, such as letters in a numeric-only field.

What are the minimum touch target sizes for mobile interfaces?▼

Touch targets must be at least 44x44px, with 48x48px ideal, to prevent fat-finger errors. Primary actions should sit in the thumb zone at the center and lower screen areas, avoiding top corners.

When should I not use this usability audit skill?▼

Do not use it as the primary guide for backend architecture, threat modeling, or release operations. It is scoped to UX architecture, visual hierarchy, responsiveness, and interface behavior evaluation.