ux-audit

Audit UI code by simulating user behavior and generating severity-ranked markdown reports.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/kileroppo/AI-Coding-Guidance-Skills --skill ux-audit-kileroppo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ux-audit
Source: https://github.com/kileroppo/AI-Coding-Guidance-Skills/tree/main/skills/ux-audit
Command: npx skills add https://github.com/kileroppo/AI-Coding-Guidance-Skills --skill ux-audit-kileroppo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

UX audit skills help catch usability failures early by simulating how different users actually try to complete tasks, so you can prioritize fixes instead of guessing or doing shallow reviews.

Core Features & Use Cases

  • Structured usability audit across 5 dimensions: evaluates happy-path completion, blind-user intuition, edge-case fault tolerance, state feedback, and information hierarchy.
  • Severity-ranked, implementable findings: produces HIGH/MEDIUM/LOW issues with clear user impact and concrete fixes (including file:line references for every finding).
  • Targeted scope control: audits a single file, a directory, or the whole UI project while skipping non-UI files.

Quick Start

Run the ux-audit skill by sending: /ux-audit src/pages/Login.tsx.

Frequently Asked Questions about ux-audit

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

FAQPage Schema
How do I audit UI code for usability problems before deployment?

To audit UI code for usability problems, you simulate real user behavior across five UX dimensions including happy-path completion and edge-case fault tolerance, producing a severity-ranked markdown report with file:line references for targeted fixes.

What does a UX audit cover for user flows and loading states?

A UX audit evaluates user flows and loading states by simulating task completion to check blind-user intuition, state feedback, and information hierarchy, generating a PASS/FAIL evaluation with prioritized HIGH, MEDIUM, and LOW severity findings.

Can I run a UX review on a single component or a whole UI directory?

You can run a UX review on a single component, a specific page, or an entire UI directory. The audit targets UI files specifically while automatically skipping non-UI files in your project scope.

What is the best way to prioritize UI fixes after finding accessibility issues?

The best way to prioritize UI fixes for accessibility issues is using a severity-ranked report that categorizes findings by user impact into HIGH, MEDIUM, and LOW levels, providing concrete fixes with exact file:line locations.

Does the usability audit check edge cases and fault-tolerant interactions?

The usability audit explicitly checks edge cases and fault-tolerant interactions as one of its five core UX dimensions, simulating real user behavior to identify failure points and generate actionable, severity-ranked markdown findings.

Why does my form UI fail to provide adequate state feedback to users?

Form UI fails to provide adequate state feedback when it lacks proper fault-tolerant interactions and information hierarchy. A structured UX audit simulates real behavior to identify these exact blind spots and generate concrete fixes.