Agent skill
Unity UI System Selector
Guides selection between UGUI and UI Toolkit for projects. Use when choosing UI framework or migrating UI systems.
Install this agent skill to your Project
npx add-skill https://github.com/Dev-GOM/claude-code-marketplace/tree/main/plugins/unity-dev-toolkit/skills/unity-ui-selector
SKILL.md
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
Related Skills
- 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
Dev-GOM/claude-code-marketplace
unity-editor-toolkit
Unity Editor control and automation, WebSocket-based real-time communication. 유니티에디터제어및자동화, WebSocket기반실시간통신. Features/기능: GameObject control 게임오브젝트제어, Transform manipulation 트랜스폼조작, Component management 컴포넌트관리, Scene management 씬관리, SQLite database integration SQLite데이터베이스통합, GUID-based persistence GUID기반영구식별, Multi-scene synchronization 멀티씬동기화, Command Pattern with Undo/Redo 명령패턴실행취소재실행, Menu execution 메뉴실행, ScriptableObject management 스크립터블오브젝트관리, Array/List manipulation 배열리스트조작, All field types support 모든필드타입지원, Material/Rendering 머티리얼/렌더링, Prefab system 프리팹시스템, Asset Database 애셋데이터베이스, Animation 애니메이션, Physics 물리, Console logging 콘솔로깅, EditorPrefs management 에디터프리퍼런스관리, Editor automation 에디터자동화, Build pipeline 빌드파이프라인, Lighting 라이팅, Camera 카메라, Audio 오디오, Navigation 네비게이션, Particles 파티클, Timeline 타임라인, UI Toolkit, Profiler 프로파일러, Test Runner 테스트러너. Protocol 프로토콜: JSON-RPC 2.0 over WebSocket (port 9500-9600). 500+ commands 명령어, 25 categories 카테고리. Real-time bidirectional communication 실시간양방향통신. Security 보안: Defense-in-depth 심층방어 (path traversal protection 경로순회방지, command injection defense 명령어인젝션방어, JSON injection prevention JSON인젝션방지, SQL injection prevention SQL인젝션방지, transaction safety 트랜잭션안전성). Localhost-only connections 로컬호스트전용. Cross-platform 크로스플랫폼 (Windows, macOS, Linux).
Dev-GOM/claude-code-marketplace
blender-toolkit
Blender automation with geometry creation, materials, modifiers, and Mixamo animation retargeting. Core Features: WebSocket-based real-time control, automatic bone mapping with UI review, two-phase confirmation workflow, quality assessment, multi-project support, comprehensive CLI commands. Use Cases: Create 3D primitives (cube, sphere, cylinder, etc.), manipulate objects (transform, duplicate, delete), manage materials and modifiers, retarget Mixamo animations to custom rigs with fuzzy bone matching.
Dev-GOM/claude-code-marketplace
unity-test-runner
Execute and analyze Unity Test Framework tests from the command line. This skill automates test execution for Unity projects by detecting the Unity Editor, configuring test parameters (EditMode/PlayMode), running tests via CLI, parsing XML results, and generating detailed failure reports. Use this when running Unity tests, validating game logic, or debugging test failures.
Dev-GOM/claude-code-marketplace
Unity Template Generator
Generates production-ready C# script templates (MonoBehaviour, ScriptableObject, Editor, tests). Use when creating new scripts or setting up project structure.
Dev-GOM/claude-code-marketplace
unity-compile-fixer
Detect and resolve Unity C# compilation errors using VSCode diagnostics. Use this skill when Unity projects have compilation errors that need diagnosis and automated fixes. Analyzes errors from VSCode Language Server, proposes solutions based on error patterns, and handles version control conflicts for Unity projects.
Dev-GOM/claude-code-marketplace
Unity UI Toolkit
Assists with Unity UI Toolkit development - UXML structure, USS styling, C# VisualElement manipulation, data binding, and custom controls. Use when implementing UI Toolkit interfaces.
Didn't find tool you were looking for?