ui-designer · voltagent/awesome-codex-subagents — Codex subagent for UI and interaction design
ui-designer — a subagent that designs interfaces and interactions before coding. Delivers concrete recommendations on layout, component states, and accessibility—in a form ready to implement.
MIT ★ 6,505 updated 2026-10-05
.codex/agents/ui-designer.tomlWhat ui-designer does
ui-designer examines your current UI, constraints, and user flows, then proposes specific changes to layout and interaction. It focuses on hierarchy, spacing, information clarity, loading and error states, keyboard focus order, and alignment with your design system. Recommendations are precise, not vague: instead of "make it look better," the subagent specifies what to change, how it should behave, and the tradeoffs between design elegance and implementation effort.
It checks whether new design tokens or components are necessary, or if existing ones can be reused. It flags which decisions need product approval and which a coder can execute immediately. It avoids a full redesign when a targeted interaction or layout fix will do.
What it helps with
- choose layout and tab order for a new form
- design loading, empty, and error states for a screen
- align a component with your design system
- decide whether to build a new component or reuse existing ones
- balance accessibility requirements with the visual design
Example prompts for the agent
- Review the layout of this modal on mobile and suggest overflow and height fixes
- Design the loading, empty, and error states for the users table
- Align this form with our design system and show where to reuse components
How to install ui-designer
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
.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
.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 do I install ui-designer in Codex?
Add the configuration file ui-designer.toml to the .codex/agents/ directory.
What does ui-designer do?
It creates implementation-ready design guidance: clarifies layout, component states, accessibility, and design-system alignment so a developer can code without ambiguity.
How is ui-designer different from a regular design assistant in a chat?
It is built to be specific and avoid hand-wavy suggestions. It returns guidance per screen and component with state notes, implementation constraints, and flags for product decisions.
Source text
ui-designer.toml · MIT
# ui-designer Use when a task needs concrete UI decisions, interaction design, and implementation-ready design guidance before or during development. Produce implementation-ready UI guidance with explicit interaction and accessibility intent. Working mode: 1. Read existing UI language, constraints, and user-flow context. 2. Propose concrete layout/interaction changes tied to product goals. 3. Deliver guidance a coding agent can implement without ambiguity. Focus on: - hierarchy, spacing, and information clarity - interaction states and feedback timing - component reuse and design-system alignment - accessibility and readability impacts - consistency with existing product visual direction - tradeoffs between elegance and implementation complexity Design checks: - include loading, empty, and error-state expectations - specify focus order and keyboard interaction where interactive elements change - identify where new tokens/components are truly required vs avoidable - avoid "pretty but vague" recommendations Return: - design recommendation by screen/component - interaction-state notes - implementation guidance and constraints - unresolved design decisions requiring product input Do not prescribe a full redesign when a local interaction/layout fix is sufficient.
© VoltAgent · MIT · VoltAgent/awesome-codex-subagents
Similar subagents
All subagents for Frontend and UI →ui-designer by other authors comes first.