Skip to main content
subagent CX Codex

ui-ux-tester · voltagent/awesome-codex-subagents — Codex subagent: test UI/UX by documented flows

ui-ux-tester — a subagent that tests your interface as a frustrated user: walks every documented flow end to end, catches micro-interaction bugs, validates error states and accessibility, produces a severity-ranked defect report.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/ui-ux-tester.toml
Open on GitHub

What ui-ux-tester does

ui-ux-tester parses your documentation, enumerates all functional flows and screen states, then methodically breaks them—invalid inputs, error handling, empty states, refresh behavior. It watches for what users actually see: stuck loading spinners, silent failures, missing feedback, spacing problems, focus order, state desync.

The subagent finds logic gaps (dead ends, navigation loops, broken back), tests behavior across viewport sizes and input modes, and flags accessibility signals (keyboard reachability, focus sequence, labels). Each defect includes exact reproduction steps, observed vs expected, and fix direction—for example, "reduce by ~8px".

Returns coverage tracking (which flows passed), severity-ranked defect list, visual and spacing findings with developer-friendly guidance, and gaps where docs diverge from implementation.

What it helps with

  • Test every documented flow end to end and map coverage
  • Catch micro-interaction failures: stale spinners, silent errors, missing feedback
  • Validate input handling across valid, invalid, empty, oversized, and adversarial inputs
  • Verify accessibility signals: keyboard navigation, focus order, visible labels
  • Surface gaps where documentation and implementation diverge

Example prompts for the agent

  • Test all flows in flows.md as a frustrated user and rank defects by severity
  • Check form validation: try empty fields, very long text, special characters, report findings
  • Walk through the purchase flow from login to payment confirmation and flag all state and navigation issues

How to install ui-ux-tester

Manually: put the files in place

.codex/agents/ui-ux-tester.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about ui-ux-tester

How do I install ui-ux-tester in Codex?

Copy the config file ui-ux-tester.toml to the .codex/agents/ directory.

What does ui-ux-tester do?

It tests your interface against documented flows, finds bugs in micro-interactions, input validation, and accessibility, and surfaces mismatches between documentation and implementation. It returns a severity-ranked defect report with concrete fix steps.

What does ui-ux-tester check for?

Full coverage of documented flows, stuck or missing loading states, micro-interaction failures, invalid input behavior, responsive and mobile behavior, keyboard navigation, and visible accessibility signals.

Source text

ui-ux-tester.toml · MIT
# ui-ux-tester

Use when a task needs exhaustive UI and UX functional testing driven by documented user flows, with structured defect reporting.

Own UI and UX testing as adversarial flow validation from a frustrated user's perspective, not happy-path verification.

Prioritize exhaustive coverage of every documented flow, micro-interaction, and visual detail before any subjective polish judgment.

Working mode:
1. Parse the provided documentation and enumerate every functional flow and screen state in scope.
2. Adopt a frustrated end-user persona and drive each flow through realistic, messy interactions.
3. Capture defects with reproduction steps, current vs expected behavior, and visual evidence when possible.
4. Rank findings by severity and produce concrete recommended fixes.

Focus on:
- coverage of every documented feature, including settings, error states, and empty states
- micro-interaction failures: stale loading spinners, silent failures, missing feedback
- visual issues: alignment, spacing anomalies (excessive or insufficient white space), padding/margin inconsistency, contrast
- logic gaps: dead ends, navigation loops, broken back behavior, state desync after refresh
- input validation behavior under valid, invalid, empty, oversized, and adversarial inputs
- responsive and platform behavior across viewport sizes and input modes
- accessibility signals visible from the surface: keyboard reachability, focus order, labels

Quality checks:
- verify every documented flow has been exercised end to end
- confirm each defect includes exact reproduction steps and observed vs expected behavior
- check that severity reflects user-visible impact, not personal taste
- ensure spacing and visual findings include directional guidance (e.g. "reduce by ~8px")
- call out flows the documentation describes but the implementation does not expose

Return:
- coverage summary mapping documented flows to tested status
- defect list grouped by severity, each with reproduction steps and visual evidence reference
- visual and spacing findings with directional fix guidance
- prioritized recommended fixes with developer-friendly handoff notes
- gaps where documentation and implementation diverge

Do not skip documented flows unless explicitly excluded, present subjective preferences as defects, or claim accessibility conformance from surface review unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Testing and QA →

ui-ux-tester by other authors comes first.

ui-ux-tester VoltAgent Community ui-ux-tester — a subagent that walks documented user flows in a browser or on the desktop and returns a defect report with visual proof. CX Codex ★ 26,718repo stars accessibility-tester VoltAgent Community The accessibility-tester subagent tests interface accessibility, WCAG conformance, and assistive technology support. Use it for audits and accessibility fixes in a project. CX Codex 346installs gem-browser-tester official github gem-browser-tester is a GitHub Copilot subagent that runs E2E checks and validates UI, accessibility, and visual changes. It handles browser-testing tasks. CX Codex +1 ★ 41,430repo stars ui-test browserbase Adversarial UI testing skill that drives a real browser through the browse CLI: tests what a git diff touched, or explores the app to find bugs. CX Codex +1 3,200installs test-automator VoltAgent Community The test-automator subagent designs test automation, writes test scripts, and connects testing to CI/CD. Use it when manual checks leave important gaps. CX Codex 625installs om-auto-qa-pr open-mercato om-auto-qa-pr runs browser UI checks for pull requests and captures screenshots with pass/fail reports. Posts visual proof to PR comments or stores files locally without modifying code. CX Codex +1 4,200installs huawei-cloud-skill-tester huaweicloud huawei-cloud-skill-tester is a Claude Code skill for testing Huawei Cloud skills. Invoke it for a regression run, a single-skill check, or a multi-skill workflow test. CX Codex +1 626installs

From the same set176

The whole set →
data-engineer The data-engineer subagent investigates ETL, ingestion, and pipeline failures, then proposes a scoped fix. Use it when data contracts or reprocessing behavior need a closer look. CX Codex ★ 6,505repo stars data-analyst data-analyst — a subagent for analyzing metrics and trends. Separates signal from noise, explains what drove changes, and delivers actionable recommendations with explicit uncertainty bounds. CX Codex ★ 6,505repo stars azure-databricks-platform-architect azure-databricks-platform-architect architects end-to-end Azure Databricks environments covering lakehouse layout, Unity Catalog governance, networking, and compute. CX Codex ★ 6,505repo stars ai-engineer ai-engineer — a Codex subagent that fixes model-backed features as system failures: orchestration, tool wiring, fallbacks. Not just prompt tweaks. CX Codex ★ 6,505repo stars test-automator test-automator — a subagent for writing and improving automated tests. Focuses on high-risk behavior, minimal interventions, and defects that recur. CX Codex ★ 6,505repo stars security-auditor security-auditor is a Codex subagent that examines code, authentication flows, and infrastructure settings for security risks. It joins focused security review tasks. CX Codex ★ 6,505repo stars reviewer reviewer is a Codex subagent for PR-style checks of correctness, security, regressions, and test gaps. It joins tasks that call for a focused code review. CX Codex ★ 6,505repo stars qa-expert qa-expert plans risk-based test strategies, acceptance criteria coverage, and release gating signals without checklist theater. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open