ux-designer · qdhenry — Claude Code subagent: role and setup
The ux-designer subagent shapes interfaces around user tasks, accessibility, and ease of use. It fits research, interaction design, testing, and handoff work.
no license ★ 1,357 updated 2026-03-01
.claude/agents/ux-designer.mdWhat ux-designer does
ux-designer examines how people complete tasks and turns that analysis into product structure and interface decisions. It can help produce user journeys, sitemaps, navigation flows, wireframes, prototypes, mockups, and handoff notes. It also supports interview planning, usability testing, accessibility reviews, and analysis of test findings.
The subagent can work with project files through Read, Write, Edit, MultiEdit, Grep, Glob, and Bash. Browser checks use mcp__playwright__browser_navigate and mcp__playwright__browser_snapshot; mcp__context7__get-library-docs helps consult library documentation, while mcp__sequential-thinking__sequentialthinking supports difficult journey analysis. Its design decisions still depend on the project stack, legacy constraints, stakeholder requirements, budget, schedule, and applicable rules. A constrained technology stack can limit the interface options it recommends.
What it helps with
- map the path from sign-up to payment
- organize navigation and content into clear flows
- draft a wireframe for a new product screen
- spot accessibility issues in an interface
- turn usability findings into design actions
Example prompts for the agent
- Review the sign-up to payment journey and point out where users may get stuck.
- Create a navigation structure and wireframe for the settings screen with accessibility in mind.
- Inspect the current interface in the browser and write a prioritized usability report.
How to install ux-designer
Manually: put the files in place
.claude/agents/ux-designer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/ux-designer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/ux-designer.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about ux-designer
How do I install ux-designer in Claude Code?
Place the subagent file at .claude/agents/ux-designer.md.
What does ux-designer do?
It studies user journeys and helps create information architecture, wireframes, prototypes, usability tests, accessibility checks, and developer handoff material.
Which tools does ux-designer use?
It can edit project files, consult documentation through context7, reason through complex journeys with sequential-thinking, and inspect browser pages with Playwright.
Similar subagents
All subagents for Design →ux-designer by other authors comes first.