Godot Ui Containers

This is your reference for building responsive UIs in Godot without fighting the layout system. It covers the full container toolkit (HBox, VBox, Grid, Flow, Split, Scroll) with real patterns like breakpoint-based layouts, virtual list pooling for performance, and aspect-ratio-locked cards. The NEVER section is genuinely useful: it warns you about the one-frame scroll delay bug, the mouse_filter trap that blocks clicks, and why you can't manually set positions inside containers. The expert patterns show you how to build split-screen views, radial layouts via NOTIFICATION_SORT_CHILDREN, and dynamic tab systems. If you're moving from manual positioning to proper container-based UI, this will save you from the common mistakes.

skills.sh installs: 279
GitHub stars: 464
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add thedivergentai/gd-agentic-skills --skill godot-ui-containers --agent claude-code

Installs into .claude/skills of the current project.

Files

Decision Tree: Container type → script

Need	Prefer	MANDATORY script
Breakpoint shell / full-screen adaptive root	Margin + Box containers	responsive_layout_builder.gd
Fixed columns that change with width	`GridContainer`	responsive_grid.gd / responsive_inventory_grid.gd
Wrapping chips / tags	`HFlowContainer`	responsive_tag_cloud.gd
Thousands of scroll rows	Virtual pool (not raw children)	virtual_list.gd
Log/chat autoscroll	`ScrollContainer`	terminal_autoscroll.gd
3D character/item preview in UI	`SubViewportContainer`	viewport_3d_preview.gd
Deep nesting causing layout spikes	Anchors/offsets instead	performance_anchor_layout.gd
Radial/wheel menus	Custom `Container`	custom_radial_container.gd