What problem does it solve?
The ux-audit skill automates recurring visual and usability reviews of a live web platform to detect UI decay, surface actionable findings, and prevent regressions from accumulating unnoticed. It reduces manual screenshot review, prevents duplicate bug filings, and ensures the highest-severity UX problems on primary product surfaces are prioritized for the team.
Core Features & Use Cases
- Scheduled and on-demand audits across authenticated dashboard routes and anonymous funnel pages with configurable per-route viewport sizes.
- Automated screenshot capture via Playwright with bot-authenticated sign-in and fixture seeding to ensure reproducible states.
- Delegated design analysis: hands off screenshots to the ux-design-lead agent in audit mode and parses JSON findings.
- Deterministic deduplication and capping using SHA-256 finding hashes, global/per-run/per-route caps, and GitHub issue search to avoid duplicates.
- Dry-run and file modes: dry-run writes findings JSON/artifacts while file mode creates and attaches markdown issue bodies and screenshots via the GitHub CLI.
- Use Case: Run monthly audits to capture regression drift on the founder dashboard, automatically surface the top-priority UX issues, and file a small, curated set of issues for the design/product team.
Quick Start
Run a scheduled or local dry-run ux-audit to capture screenshots, analyze them via the ux-design-lead agent, and emit a findings JSON for review.