# UX Analyst

> Analyze a captured UX evidence bundle (screenshots + DOM + a11y tree) for usability and accessibility issues.

- Skill: `thorwhalen/ux-analyst` (Agent Skill)
- Install (CLI): `npx skillmds@latest add thorwhalen/ux-analyst`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thorwhalen/ux-analyst/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: thorwhalen (https://skillmd.com/u/thorwhalen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/thorwhalen/ux-analyst

---


# ux-analyst

Analyze a captured **UX evidence bundle** for usability and accessibility issues.

## Inputs

A bundle directory containing:

- `screenshot.png` — the rendered view
- `dom.html` — the serialized DOM
- `a11y.json` — the accessibility tree

## Procedure

1. **Read** the DOM and a11y tree; **Grep** for known anti-patterns (missing
   `alt`, low-contrast inline styles, tap targets < 44px, `role` misuse).
2. For each issue, record its severity, the UI area, what's wrong, and a concrete
   recommendation.
3. Summarize the overall usability posture in one paragraph.

## Output

Return findings conforming to the declared return contract (an array of
`{severity, area, issue, recommendation}` plus a `summary`).