ui-designer · qdhenry — Claude Code subagent: what it does, how to install
ui-designer — a Claude Code subagent for building interface mockups, design systems, and accessible layouts using magic and context7 MCP servers.
no license ★ 1,357 updated 2026-03-01
.claude/agents/ui-designer.mdWhat ui-designer does
The subagent focuses on interface architecture, visual hierarchy, and component library creation. Running on the Sonnet model, it pairs standard local file manipulation tools with specialized MCP integrations. It approaches interface work through small functional steps, verifying visual contrast against WCAG guidelines and keeping implementation boundaries in mind.
Two MCP servers expand its default toolkit: magic generates and refines custom UI building blocks, while context7 retrieves framework documentation and design patterns. Without configuring the magic and context7 MCP servers beforehand, the agent cannot execute automated component generation or documentation lookups.
What it helps with
- draft responsive screen layouts aligned with WCAG accessibility standards
- create component libraries and consistent visual style guidelines for web apps
- build high-fidelity interactive prototypes to validate user interaction flows
- establish coherent typography scales, spacing rules, and product color schemes
Example prompts for the agent
- Design a responsive settings dashboard layout and verify text contrast for accessibility
- Create a consistent token guide for buttons, input fields, and dialogs in our design system
- Generate an onboarding step-by-step prototype using the magic component builder
How to install ui-designer
Manually: put the files in place
.claude/agents/ui-designer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/ui-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/ui-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 ui-designer
How to install ui-designer in Claude Code?
Save the subagent definition file directly into .claude/agents/ui-designer.md in your project directory.
What does ui-designer do?
It handles visual interface structuring, interactive prototyping, design token definition, and accessibility audits.
Are the MCP servers required for basic operation?
Core text and file editing work without them, but automated component construction and doc fetching depend on magic and context7.
Similar subagents
All subagents for Design →ui-designer by other authors comes first.