К основному содержанию
скилл CX Codex

unity-ui-development — скилл для Claude Code

Скилл unity-ui-development помогает проектировать интерфейсы в Unity на UGUI и UI Toolkit. Подсказывает разметку UXML, стили USS, привязку данных и настройку RectTransform.

MIT 107 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-ui-development -a claude-code
Открыть на GitHub

Что делает unity-ui-development

Скилл систематизирует работу с двумя интерфейсными системами Unity: классическим UGUI на базе Canvas и UI Toolkit на UXML со стилями USS. Внутри собраны правила выбора архитектуры под платформу, шаблоны компонентов вроде инвентарей или шкал здоровья, а также рецепты адаптивной вёрстки через HorizontalLayoutGroup, GridLayoutGroup и ContentSizeFitter.

В блоке UGUI фокус сделан на якорях RectTransform, интеграции TextMeshPro и обработке событий без утечек памяти через RemoveListener в методе OnDisable. Отдельное правило касается оптимизации: динамические и статичные элементы нужно разносить по разным Canvas, потому что любое изменение перерисовывает всё дерево дочерних объектов.

Для UI Toolkit скилл даёт примеры структуры UXML, правил flexbox в USS и скриптов C# с выборкой через rootVisualElement.Q<T>(). Для проектов на Unity 2023.2 и новее описана привязка данных через INotifyBindablePropertyChanged и атрибут [CreateProperty].

Какие задачи решает

  • выбрать между UGUI и UI Toolkit под требования проекта
  • настроить адаптивные якоря RectTransform и группы раскладки
  • сверстать экран меню или HUD на UXML и USS
  • привязать данные модели к элементам UI Toolkit через C#
  • отвязать слушатели событий в OnDisable во избежание утечек памяти

Примеры запросов агенту

  • Сверстай экран характеристик персонажа на UI Toolkit с помощью UXML и USS
  • Настрой динамическую полоску здоровья на UGUI с разделением на статический и динамический Canvas
  • Покажи C#-скрипт с привязкой данных для ListView в Unity 2023.2

Как установить unity-ui-development

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-ui-development -a claude-code

2Вручную: положить файлы

~/.claude/skills/unity-ui-development/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/unity-ui-development/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об unity-ui-development

Как установить unity-ui-development в Claude Code?

Выполните команду npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-ui-development -a claude-code. Файл скилла запишется в ~/.claude/skills/unity-ui-development/SKILL.md.

Что делает скилл unity-ui-development?

Он предоставляет агенту готовые шаблоны и правила построения интерфейсов Unity для систем UGUI, TextMeshPro и UI Toolkit.

Когда стоит выбирать UGUI вместо UI Toolkit?

UGUI остаётся основным выбором для интерфейсов в мировом пространстве (World Space Canvas), проектов виртуальной или дополненной реальности и готовых ассетов. UI Toolkit лучше подходит для редакторских окон и списков данных в проектах на Unity 2023+.

Исходный текст

SKILL.md · MIT
---
name: unity-ui-development
description: |
  Unity UI development with UGUI and UI Toolkit.
  PROACTIVELY activate for: (1) building Unity user interfaces, (2) UGUI (Canvas, RectTransform, anchors), (3) UI Toolkit (USS, UXML, VisualElement), (4) EventSystem and input handling, (5) common UI components (buttons, scroll views, dropdowns), (6) inventory UIs, HUDs, health bars, menu systems, (7) TextMeshPro setup and rich text, (8) responsive UI (anchors, layout groups), (9) runtime UI generation, (10) world-space canvases for in-game UI.
  Provides: UGUI vs UI Toolkit comparison, RectTransform patterns, USS/UXML examples, layout group recipes, and TextMeshPro templates.
---

# Unity UI Development

## Overview

Unity provides two UI systems: UGUI (the established GameObject-based system) and UI Toolkit (the newer retained-mode system inspired by web technologies). This skill covers both systems, when to use each, and implementation patterns.

## Choosing a UI System

| Factor | UGUI | UI Toolkit |
|--------|------|------------|
| Runtime UI | Mature, full-featured | Supported (Unity 2023+) |
| Editor UI | Not supported | Primary system for editor |
| World-space UI | Excellent (World Space Canvas) | Limited |
| Animation/Tweening | DOTween, Animator, LeanTween | USS transitions, C# manipulation |
| Styling | Per-element, manual | USS stylesheets (CSS-like) |
| Performance | Draw call heavy with many canvases | Retained mode, lighter draw calls |
| Learning curve | Lower for Unity devs | Higher (web-like paradigm) |
| VR/AR | Well-supported | Limited world-space support |

**Recommendation:** Use UGUI for world-space UI, VR/AR, and projects needing maximum asset store compatibility. Use UI Toolkit for editor extensions, complex data-driven UIs (lists, trees), and projects on Unity 2023+.

## UGUI (Canvas-Based UI)

### Canvas Setup

| Render Mode | Use For | Notes |
|-------------|---------|-------|
| Screen Space - Overlay | HUD, menus | Always on top, no camera needed |
| Screen Space - Camera | Post-processing on UI | Assign render camera |
| World Space | In-game signs, health bars | Set event camera for interaction |

**Performance rule:** Separate static and dynamic UI into different Canvases. A Canvas rebuilds ALL children when any child changes.

### RectTransform Anchoring

```bash
Anchor presets control how elements resize with parent:
- Stretch-Stretch: Element fills parent (full-screen backgrounds)
- Center-Center: Fixed size at center (popup dialogs)
- Bottom-Left: Fixed corner position (minimap)
- Top-Stretch: Stretches horizontally, fixed at top (nav bar)
```

Set anchors via the RectTransform anchor preset widget (hold Alt+Shift to also set pivot and position). Use `anchorMin`, `anchorMax`, `offsetMin`, `offsetMax` in code.

### Layout Components

| Component | Purpose |
|-----------|---------|
| `HorizontalLayoutGroup` | Arrange children left-to-right |
| `VerticalLayoutGroup` | Arrange children top-to-bottom |
| `GridLayoutGroup` | Grid arrangement (inventory slots) |
| `LayoutElement` | Override min/preferred/flexible size |
| `ContentSizeFitter` | Auto-resize to content |
| `AspectRatioFitter` | Maintain aspect ratio |

Disable `Layout.childForceExpandWidth/Height` to prevent unwanted stretching.

### Event Handling

```csharp
using UnityEngine.UI;
using TMPro;

[SerializeField] Button startButton;
[SerializeField] TMP_InputField nameField;
[SerializeField] Slider volumeSlider;

void OnEnable()
{
    startButton.onClick.AddListener(OnStartClicked);
    nameField.onEndEdit.AddListener(OnNameChanged);
    volumeSlider.onValueChanged.AddListener(OnVolumeChanged);
}

void OnDisable()
{
    startButton.onClick.RemoveListener(OnStartClicked);
    nameField.onEndEdit.RemoveListener(OnNameChanged);
    volumeSlider.onValueChanged.RemoveListener(OnVolumeChanged);
}
```

Always `RemoveListener` in `OnDisable` to prevent leaks and ghost references.

### TextMeshPro

Always use TextMeshPro (`TMP_Text`, `TextMeshProUGUI`) over legacy `Text`. Import TMP Essentials when prompted. Use rich text tags: `<color=#FF0000>`, `<b>`, `<size=24>`, `<sprite=0>` for inline icons.

## UI Toolkit (USS/UXML)

### Architecture

```text
UI Toolkit Stack:
  UXML  -- Structure (like HTML)
  USS   -- Styling (like CSS)
  C#    -- Logic (like JavaScript)
```

### UXML Structure

```xml
<ui:UXML xmlns:ui="UnityEngine.UIElements">
    <ui:VisualElement class="container">
        <ui:Label text="Player Stats" class="title" />
        <ui:ProgressBar name="health-bar" title="HP" high-value="100" />
        <ui:Button name="attack-btn" text="Attack" class="action-btn" />
        <ui:ListView name="inventory-list" />
    </ui:VisualElement>
</ui:UXML>
```

### USS Styling

```css
.container {
    flex-direction: column;
    padding: 10px;
    background-color: rgba(0, 0, 0, 0.8);
    border-radius: 8px;
}

.title {
    font-size: 24px;
    color: white;
    -unity-font-style: bold;
    margin-bottom: 10px;
}

.action-btn {
    height: 40px;
    background-color: #4CAF50;
    color: white;
    border-radius: 4px;
    transition-duration: 0.2s;
}

.action-btn:hover {
    background-color: #66BB6A;
    scale: 1.05 1.05;
}
```

Key USS differences from CSS: use `-unity-` prefix for Unity-specific properties. Flexbox is the layout model (default `flex-direction: column`). Use `transition-duration`, `transition-property` for animations.

### C# Integration

```csharp
[RequireComponent(typeof(UIDocument))]
public class StatsUI : MonoBehaviour
{
    void OnEnable()
    {
        var root = GetComponent<UIDocument>().rootVisualElement;
        var healthBar = root.Q<ProgressBar>("health-bar");
        var attackBtn = root.Q<Button>("attack-btn");
        var inventory = root.Q<ListView>("inventory-list");

        attackBtn.RegisterCallback<ClickEvent>(OnAttack);
        healthBar.value = player.Health;

        // ListView binding
        inventory.makeItem = () => new Label();
        inventory.bindItem = (element, index) =>
            ((Label)element).text = items[index].Name;
        inventory.itemsSource = items;
    }
}
```

Query elements with `Q<T>("name")` or `Q<T>(className: "class")`. Register callbacks with `RegisterCallback<EventType>`. Always query from `rootVisualElement`.

### Data Binding (Unity 2023.2+)

```csharp
// Runtime data binding with [CreateProperty] and INotifyBindablePropertyChanged
public class PlayerData : INotifyBindablePropertyChanged
{
    public event EventHandler<BindablePropertyChangedEventArgs> propertyChanged;
    private int _health;

    [CreateProperty]
    public int Health
    {
        get => _health;
        set { _health = value; Notify(); }
    }
    void Notify([CallerMemberName] string prop = "")
        => propertyChanged?.Invoke(this, new BindablePropertyChangedEventArgs(prop));
}
```

Bind in UXML with `binding-path="Health"` or in C# with `element.SetBinding("value", new DataBinding { dataSourcePath = ... })`.

## Common UI Patterns

| Pattern | UGUI Approach | UI Toolkit Approach |
|---------|---------------|---------------------|
| Popup dialog | Enable/disable child panel | Add/remove from visual tree |
| Scroll list | ScrollRect + VerticalLayoutGroup | ListView (virtualized) |
| Drag-and-drop | IBeginDragHandler, IDragHandler, IEndDragHandler | PointerManipulator |
| Tab system | Toggle group + panels | RadioButtonGroup + display toggling |
| Tooltip | Follow cursor panel | Manipulator + VisualElement positioning |
| Screen fade | CanvasGroup.alpha tween | USS opacity transition |

## Additional Resources

### Reference Files
- **`references/ugui-patterns.md`** -- Advanced UGUI patterns: scroll optimization, dynamic layouts, world-space interaction, localization, safe area handling, screen adaptation
- **`references/ui-toolkit-advanced.md`** -- Custom controls, ListView/TreeView mastery, custom manipulators, editor UI integration, theming, responsive layouts

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
ui-uitk Unity-Technologies Скилл ui-uitk для понимания, редактирования и генерации UXML и USS в Unity UI Toolkit. Помогает создавать интерфейсы с flex-вёрсткой, кастомными элементами и runtime-биндингом. CX Codex +1 7 700установок scenario-unity-ui scenario-labs Скилл scenario-unity-ui для игрового UI в Unity 6.3: меню, настройки, HUD, шкала здоровья, рамка миникарты. Помогает выбрать uGUI или UI Toolkit и проверить вёрстку на всех экранах. CX Codex +1 579установок ui Unity-Technologies Скилл ui для Claude Code выбирает подходящую UI-систему Unity и направляет запрос к профильному скиллу. Срабатывает, когда нужно создать или изменить интерфейс, а фреймворк не назван. CX Codex +1 6 500установок unity-development akiojin Скилл unity-development для Claude Code помогает вести Unity-разработку, выбирая MCP-инструменты для кода, сцен, ассетов и PlayMode. Охватывает задачи на C#, UI и тестирование. CX Codex +1 1установок unity-csharp-scripting gamedev-skills Скилл unity-csharp-scripting для Claude Code пишет и исправляет игровые скрипты на C# для Unity 6.3 LTS. Подключается при создании или переименовании .cs-файлов, ошибке «Missing script» и пропавшем поле в Inspector. CX Codex +1 11 700установок unity-animation gamedev-skills Скилл unity-animation для Claude Code управляет анимацией персонажей в Unity 6.3 LTS через контроллеры Animator и Mecanim. CX Codex +1 11 400установок

Из того же набора96

Весь набор →
ffmpeg-video-analysis Скилл ffmpeg-video-analysis для Claude Code анализирует видео через фильтры FFmpeg и помогает искать дефекты и оценивать качество. Включается для проверки чёрных и замороженных кадров, размытости, склеек и кадрирования. CX Codex +1 111установок viral-video-platform-specs Скилл viral-video-platform-specs для Claude Code подбирает параметры экспорта видео для соцсетей. Запускается при поиске требований платформы, конвертации кадра или подготовке ролика к загрузке. CX Codex +1 108установок ffmpeg-glitch-distortion-effects Скилл ffmpeg-glitch-distortion-effects для Claude Code подсказывает фильтры FFmpeg для глитч-эффектов и искажений видео. Активируется для датамоша, VHS-симуляции, цветовых сдвигов и пикселизации. CX Codex +1 107установок ffmpeg-opencv-integration Скилл ffmpeg-opencv-integration для Claude Code и Codex помогает связать FFmpeg и OpenCV в Python-скриптах. Защищает от путаницы в RGB/BGR, сбоев с пайпами и потери звука при обработке кадров. CX Codex +1 107установок viral-video-platform-algorithms Скилл viral-video-platform-algorithms для Claude Code разбирает алгоритмы TikTok, YouTube, Instagram и Facebook. Активируется для стратегии продвижения, охватов, хештегов и времени публикаций. CX Codex +1 106установок azure-ml-foundry-workspace Скилл azure-ml-foundry-workspace для Claude Code настраивает Azure Machine Learning и Azure AI Foundry: рабочие пространства, сети, вычисления и развёртывание моделей. Разбирает конфигурацию и журналы. CX Codex +1 105установок ffmpeg-animation-timing-reference Скилл ffmpeg-animation-timing-reference для Claude Code разбирает единицы времени в FFmpeg и субтитрах ASS/SSA. Помогает выбрать длительность анимации, перехода или подписи и проверить синхронизацию. CX Codex +1 104установок unity-networking Скилл unity-networking для Claude Code помогает разрабатывать сетевую многопользовательскую игру в Unity. Активируется для настройки NGO, Mirror, Photon или Fish-Net, а также RPC и лобби. CX Codex +1 103установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой