Unity UI Toolkit Skill for AI Agents

This skill transforms your AI agent (e.g., Claude Code, Antigravity, Gemini) into a Senior Unity UI Architect, providing expert guidance on building high-performance, scalable interfaces using Unity's modern UI Toolkit (formerly UIElements). It covers the full spectrum of UI development, including both Custom Editor Tooling and Runtime Gameplay UI.

🧠 Architectural Philosophy

This skill enforces a Retained-Mode mental model, moving away from legacy immediate-mode (IMGUI) patterns. It prioritizes:

• Unity 6 Standards: Modern MVVM Data Binding, the UI Renderer for world-space, and specialized [UxmlElement] attributes.
• Performance First: Collection virtualization, element pooling, and mesh-based rendering optimizations.
• Professional Tooling: Robust EditorWindow persistence, the "Serialization Bridge" for automatic binding, and native theming support.

📦 Installation

Option 1: All Agents (Recommended)

Install the skill globally using skills.sh:

npx skills add https://github.com/GalitMash/unity-ui-toolkit-skill --skill unity-ui-toolkit

Option 2: Specific Agent via NPX

Install the skill for a specific agent by running this command in the agent's configuration folder (e.g., ~/.claude, ~/.gemini, ~/.antigravity):

npx unity-ui-toolkit-skill

Option 3: Manual Installation

Copy the unity-ui-toolkit folder (containing SKILL.md and the references/ directory) directly into your agent's skills folder.

📂 Directory Structure

The skill uses a modular, context-efficient reference system to protect the AI's context window:

unity-ui-toolkit/
├── SKILL.md               # The Orchestrator: Persona, technology selection, and routing
└── references/         
    ├── core.md            # Foundations: Retained-Mode, Visual Tree, Vector API, Events
    ├── editor.md          # Editor Excellence: Serialization Bridge, Custom Inspectors, Windows
    └── runtime.md         # Runtime UI: MVVM Data Binding, Scaling, Navigation, Pooling

🛠️ Expert Capabilities

Once installed, your agent will proactively act as a Senior UI Toolkit Mentor:

1. Verify Context: Check your Unity version and target platform before proposing code to ensure UI Toolkit is the right fit.
2. Propose Architecture: Suggest a layout strategy (e.g., Flexbox configuration) before generating implementation details.
3. Enforce Standards: Challenge suboptimal requests (e.g., polling for data in Update()) and provide modern, event-driven alternatives.
4. Deep Research: Automatically fetch the latest API details from the Official Unity Manual when encountering obscure components or properties.