ui-ux-audit

Audit ClickHouse Monitor dashboard routes for UI regressions and accessibility violations.

255|42|Updated Nov 16, 2023
One-click install
npx skills add https://github.com/chmonitor/chmonitor --skill ui-ux-audit-chmonitor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ui-ux-audit
Source: https://github.com/chmonitor/chmonitor/tree/main/.claude/skills/ui-ux-audit
Command: npx skills add https://github.com/chmonitor/chmonitor --skill ui-ux-audit-chmonitor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, @axe-core/playwright, pixelmatch, pngjs, and includes scripts (resource) components.

What problem does it solve?

The ClickHouse Monitor dashboard has over 85 routes, making manual UI checks tedious and error-prone. Regressions like tab-switch freezes, chart overflows, accessibility violations, and stuck loading states often slip through manual review, especially after code changes or deployments.

Core Features & Use Cases

  • Full Route Sweep: Automatically navigates every dashboard route (auto-discovered from TanStack Start file routing) to catch issues across the entire application surface.
  • Multi-Category Issue Detection: Identifies console errors, failed network requests, WCAG 2 A/AA accessibility violations, horizontal layout overflows, stuck loading skeletons, and rendered error states.
  • Visual Regression Testing: Diffs full-page screenshots against a provided baseline to detect unintended visual changes between releases.
  • Reproducible Issue Artifacts: Generates Playwright trace files and standalone headed repro scripts for every detected issue, eliminating the need to manually recreate bugs.
  • Dual Target Support: Runs against a local auth-bypassed dev server for fast CI-friendly checks, or a live Clerk-protected deployment using a persistent authenticated session to verify production-only states.

Quick Start

Use the ui-ux-audit skill to run a complete UI/UX and accessibility sweep of the ClickHouse Monitor dashboard after you deploy a code change or update to verify no pages are broken or regressed.

Frequently Asked Questions about ui-ux-audit

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

FAQPage Schema
How do I automate UI regression testing across all dashboard routes?▼

To automate UI regression testing across all dashboard routes, you can run a full route sweep that auto-discovers pages and diffs full-page screenshots against a provided baseline to detect unintended visual changes.

What's the best way to run WCAG 2 A/AA accessibility testing on a TanStack Start dashboard?▼

For WCAG 2 A/AA accessibility testing on a TanStack Start dashboard, automated Playwright scans identify accessibility violations across all auto-discovered routes, catching issues manual review often misses.

How do I detect horizontal layout overflows and stuck loading skeletons after deployment?▼

To detect horizontal layout overflows and stuck loading skeletons after deployment, run an automated full sweep of dashboard routes that identifies multi-category issues like rendering errors and console failures.

Can I run Playwright visual regression tests against a live Clerk-authenticated deployment?▼

Yes, you can run Playwright visual regression tests against a live Clerk-authenticated deployment using a persistent authenticated session to verify production-only states, or target a local auth-bypassed dev server.

How do I generate reproducible Playwright traces for detected UI bugs?▼

To generate reproducible Playwright traces for detected UI bugs, the audit creates standalone headed repro scripts and trace files for every issue, eliminating the need to manually recreate bugs.