unity-ui-development — скилл для Claude Code
Скилл unity-ui-development помогает проектировать интерфейсы в Unity на UGUI и UI Toolkit. Подсказывает разметку UXML, стили USS, привязку данных и настройку RectTransform.
MIT 107 установок ★ 66 обновлён 2026-06-18
npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-ui-development -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/unity-ui-development/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/unity-ui-development/
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-ui-development -a codex2Вручную: положить файлы
.agents/skills/unity-ui-development/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-ui-development -a cursor2Вручную: положить файлы
.cursor/skills/unity-ui-development/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/unity-master/skills/unity-ui-development2Вручную: положить файлы
.github/skills/unity-ui-development/SKILL.md1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-ui-development -a gemini-cli2Командой платформы
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/unity-master/skills/unity-ui-developmentВручную: положить файлы
.devin/skills/unity-ui-development/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-ui-development -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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