ux-audit

Evaluate interface designs against UX principles and generate structured audit reports.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill ux-audit-mathematicguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ux-audit
Source: https://github.com/MathematicGuy/team-006-vin20k/tree/main/ai20k-ux-workshop/.agents/skills/ux-audit
Command: npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill ux-audit-mathematicguy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Design reviews are often subjective and inconsistent, making it hard to systematically evaluate interfaces for visual hierarchy, accessibility, cognitive load, and navigation quality under time pressure. ## Core Features & Use Cases - Structured Design Audits: Evaluate interfaces against proven UX principles covering visual hierarchy, visual style, accessibility, navigation, usability, onboarding, social proof, and forms, with pass/warn/fail checks per category. - Decision Frameworks: Apply the 3-pillar decisioning workflow (scaffolding, decisioning, crafting) and macro bet alignment (velocity, efficiency, accuracy, innovation) to make intentional design trade-offs. - Pattern Library: Reference 12+ reusable UI pattern guides covering chunking, progressive disclosure, cognitive load, visual hierarchy, feedback, error handling, accessibility, and navigation. - Use Case: Given a screenshot or Figma link of a checkout flow, produce a JSON audit report scoring visual hierarchy, accessibility contrast ratios, and form usability, with prioritized fixes referencing specific framework sections. ## Quick Start Audit this checkout page screenshot for visual hierarchy, accessibility, and usability issues and generate a prioritized fix list.

Frequently Asked Questions about ux-audit

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

FAQPage Schema
How do I audit a UI design for UX issues?▼

Provide a screenshot, Figma link, or design description and request an audit. The skill evaluates visual hierarchy, visual style, and accessibility by default, adding contextual sections like navigation, usability, or forms when relevant, then outputs a structured report with prioritized fixes.

What UX principles are covered in a design audit?▼

Audits cover visual hierarchy, spacing, color, typography, elevation, accessibility (contrast, keyboard navigation, touch targets), cognitive load, navigation, feedback, and error handling. These are based on Nielsen's heuristics, Gestalt laws, and WCAG POUR principles.

What accessibility standards does the audit check?▼

The audit checks WCAG-based criteria including 4.5:1 contrast ratios for text, visible focus indicators, keyboard operability, 44px touch targets, alt text, semantic markup, and reduced motion support, organized under the POUR principles.

Can the audit output be used in design tools or reports?▼

Yes, audits produce a structured JSON format with sections for macro bets, JTBD statements, per-category checks with pass/warn/fail status, and ranked priority fixes referencing specific framework files, suitable for documentation or ticketing.

When should I use pattern references instead of a full audit?▼

Use pattern references when solving a specific problem like chunking content, progressive disclosure, or error handling, rather than reviewing a complete design. Each pattern file lists benefits, psychological principles, and implementation guidelines.