uxbyissa

Ux Ui Audit

Name: Ux Ui Audit
Author: uxbyissa

Security community

SOURCE https://github.com/uxbyissa/ux-ui-audit

Description

Evidence-backed UX/UI audit skill for Claude. Browser probes that measure real numbers — WCAG contrast, Fitts, Hick, Gestalt, design-system conformance — plus an Arabic/RTL engine no mainstream tool covers.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

ux-ui-audit

[![probes](https://github.com/uxbyissa/ux-ui-audit/actions/workflows/probes.yml/badge.svg)](https://github.com/uxbyissa/ux-ui-audit/actions/workflows/probes.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-3b82f6.svg)](LICENSE) [![Probes](https://img.shields.io/badge/probes-8-22c55e.svg)](scripts/) [![WCAG](https://img.shields.io/badge/WCAG-2.2-8b5cf6.svg)](references/wcag-thresholds.md) [![RTL + LTR](https://img.shields.io/badge/i18n-RTL%20%2B%20LTR-f59e0b.svg)](references/arabic-rtl.md) [![Dependencies](https://img.shields.io/badge/dependencies-none-64748b.svg)](scripts/)

A [Claude](https://claude.com/claude-code) skill that audits a live web interface and produces a report where **every finding carries a measurement or a verbatim quote**.

It ships browser probe scripts rather than prose instructions, because the difference between a useful audit and a generated-sounding one is whether the numbers are real.

"the focus ring could have better contrast"          ← ignorable
"outline: 1.6px solid rgb(0,75,254) on rgb(20,22,28)
 = 2.96:1; WCAG 2.2 SC 1.4.11 requires 3:1"          ← fixed that afternoon

What it covers

**Structural**, via bundled probes — WCAG contrast ratios computed from the spec formula, tap-target geometry, focus-ring contrast, accessible-name resolution, duplicate link destinations, route health, heading outline, head/SEO tags, layout overflow, navigation timing.

**Design psychology, as arithmetic rather than impression** — Hick's Law (`log2(n+1)` over the choices actually on screen), Fitts's Law (`log2(D/W + 1)` measured from thumb rest on touch), design-system conformance (distinct rendered values for type, spacing, radius and colour — a product with 40 font sizes does not have a type scale, whatever the design file says), interaction-state coverage read from the stylesheets, and microcopy presence.

**Semantic**, via a guided reading pass — the defects no automated tool detects because they require un