unity-ui-system-selector

Dev-GOM's avatarfrom Dev-GOM

Guides selection between UGUI and UI Toolkit for projects. Use when choosing UI framework or migrating UI systems.

⭐29stars🔀3forks📁View on GitHub🕐Updated Dec 2, 2025

When & Why to Use This Skill

This Claude skill acts as a specialized consultant for Unity developers, providing a structured decision framework to choose between UGUI and UI Toolkit. It optimizes the technical planning phase by evaluating Unity versions, project complexity, and performance requirements to ensure the most effective UI architecture and migration strategy.

Use Cases

  • Project Initialization: Determining the most suitable UI framework for new Unity projects based on version compatibility (2021.2+) and team expertise.
  • UI System Migration: Planning and executing the transition from legacy UGUI to the modern UI Toolkit with clear strategy and timeline guidance.
  • Performance Optimization: Evaluating UI systems for complex, data-driven interfaces like inventory systems or skill trees to ensure high-performance rendering.
  • Editor Tool Development: Selecting the recommended UI Toolkit framework for building custom Unity Editor windows and inspectors to enhance developer workflows.
nameUnity UI System Selector
descriptionGuides selection between UGUI and UI Toolkit for projects. Use when choosing UI framework or migrating UI systems.

Unity UI System Selector

Helps you choose the appropriate UI system for your Unity project and provides implementation guidance for both UGUI and UI Toolkit.

Two UI Systems

UGUI (Legacy) - GameObject-based (2014). Mature, works on all Unity versions, large community. Weaker: Complex UI performance, limited styling, no live reload.

UI Toolkit (Modern) - Retained mode, web-inspired UXML/USS (2021.2+). Better performance, live reload, data-binding. Weaker: Requires 2021.2+, smaller community, limited 3D world-space UI.

Decision Framework

Use UGUI if:

  • Unity < 2021.2
  • Simple UI (menus, HUD)
  • 3D world-space UI needed
  • Team knows UGUI well / tight deadline
  • Legacy project

Use UI Toolkit if:

  • Unity 2021.2+ and new project (future-proof)
  • Complex/data-driven UI (inventory, skill trees)
  • Editor tools (inspectors, windows) - strongly recommended
  • Web dev background (HTML/CSS)
  • Large-scale UI (MMO, strategy games)

When in doubt: For new projects on Unity 2021.2+, UI Toolkit is recommended.

Comparison

Feature UGUI UI Toolkit
Version 4.6+ 2021.2+
Performance Simple UIs All UIs
Styling Inspector CSS-like USS
Layout Manual/Groups Flexbox-like
Editor Tools Good Excellent
Runtime UI Excellent Good
3D World UI Excellent Limited

Migration

See migration-guide.md for UGUI → UI Toolkit migration strategy (3-4 months for medium projects).

UI System Support Matrix

Unity Version UGUI UI Toolkit (Editor) UI Toolkit (Runtime)
2019.4 LTS ✅ Full ✅ Basic ❌ No
2020.3 LTS ✅ Full ✅ Good ⚠️ Experimental
2021.3 LTS ✅ Full ✅ Excellent ✅ Production
2022.3 LTS+ ✅ Full ✅ Primary ✅ Full

When to Use vs Other Components

Use this Skill when: Choosing between UGUI and UI Toolkit, understanding UI system trade-offs, or planning UI migration

Use @unity-scripter agent when: Implementing UI components, writing custom UI scripts, or converting UI code

Use @unity-architect agent when: Designing complex UI architecture, planning UI data flow, or structuring large-scale UI systems

Use /unity:new-script command when: Generating Editor scripts with UI Toolkit or UGUI templates

  • unity-uitoolkit: Assists with UI Toolkit implementation (UXML, USS, VisualElement API)
  • unity-template-generator: Generates Editor scripts using selected UI system
  • unity-script-validator: Validates UI code patterns