plugins/unity-dev-toolkit/skills/unity-ui-selector/SKILL.md
Guides selection between UGUI and UI Toolkit for projects. Use when choosing UI framework or migrating UI systems.
npx skillsauth add dev-gom/claude-code-marketplace Unity UI System SelectorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Helps you choose the appropriate UI system for your Unity project and provides implementation guidance for both UGUI and UI Toolkit.
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.
Use UGUI if:
Use UI Toolkit if:
When in doubt: For new projects on Unity 2021.2+, UI Toolkit is recommended.
| 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 |
See migration-guide.md for UGUI → UI Toolkit migration strategy (3-4 months for medium projects).
| 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 |
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
tools
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).
tools
Assists with Unity UI Toolkit development - UXML structure, USS styling, C# VisualElement manipulation, data binding, and custom controls. Use when implementing UI Toolkit interfaces.
tools
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.
testing
Generates production-ready C# script templates (MonoBehaviour, ScriptableObject, Editor, tests). Use when creating new scripts or setting up project structure.