# godot-ui-containers

Provides blueprints and rules for responsive Godot UI using Container nodes. Useful when building adaptive menus, shop grids, or virtualized scroll lists.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 507 installs · ★ 893
- Author: thedivergentai
- License: LGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-ui-containers/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/godot-ui-containers

## What it does

The skill equips coding assistants with blueprints and GDScript patterns for Godot engine interfaces. It maps common UI needs to specific implementations: dynamic inventory grids via `responsive_grid.gd`, wrapping chips with `HFlowContainer`, and 3D item previews using `SubViewportContainer`. Long chat feeds and logs use a recycled control pool from `virtual_list.gd` to maintain stable frame rates.

The instructions enforce strict layout rules. Changing child node `position` or `size` directly inside a container breaks UI logic, because `queue_sort()` will instantly overwrite those transforms. The blueprint demands using `custom_minimum_size` and expansion flags instead. When adding elements to a `ScrollContainer`, the assistant waits for `await get_tree().process_frame` so the scroll offset does not miss the new frame.

Deep container hierarchies above 10 levels are flagged as performance hazards. For static padding and offsets, the skill swaps heavy container chains for lightweight anchor offsets via `performance_anchor_layout.gd`.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ui-containers -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/godot-ui-containers/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/godot-ui-containers/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ui-containers -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/godot-ui-containers/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ui-containers -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-ui-containers/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-ui-containers
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-ui-containers/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ui-containers -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-ui-containers
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/godot-ui-containers/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ui-containers -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-ui-containers/SKILL.md

## When to use it
- build dynamic inventory grids that adjust columns to screen width
- recycle list items to prevent frame drops in long scroll views
- stop overlay panels from blocking clicks with proper mouse_filter modes
- fix the single-frame delay glitch during terminal autoscrolling
- reduce container nesting spikes by switching to anchor layouts

## Example prompts
- Build a responsive inventory grid in Godot using responsive_grid.gd
- Optimize a long list in ScrollContainer with virtual_list.gd
- Implement terminal autoscroll in Godot handling the single-frame delay

## Similar
- [godot-ui-control](https://affpapa.org/en/nevibecode/skills/godot-ui-control.md) — skill · 6700 installs
- [godot-gdscript](https://affpapa.org/en/nevibecode/skills/godot-gdscript.md) — skill · 6500 installs
- [godot-best-practices](https://affpapa.org/en/nevibecode/skills/godot-best-practices.md) — skill · 2100 installs
- [cli-anything-godot](https://affpapa.org/en/nevibecode/skills/cli-anything-godot.md) — skill · 548 installs
- [godot-ui](https://affpapa.org/en/nevibecode/skills/godot-ui.md) — skill · 2700 installs
- [godot-prompter](https://affpapa.org/en/nevibecode/plugins/godot-prompter.md) — plugin · ★ 867

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 51 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
