# godot-builder

godot-builder is a Claude Code skill that automates Godot CLI workflows for scene creation, 3D asset processing, and CI exports, including headless tasks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 268 installs · ★ 983 repo stars
- 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-builder/SKILL.md
- Updated: 2026-10-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/godot-builder

## What it does

\`godot-builder` lays out CLI workflows for Godot projects, including turning glTF assets into scenes with collisions, optimizing CSG geometry, and preparing CI exports. Its toolkit includes scripts for asset processing, collision generation, test runs, and exporting. Each workflow gives an ordered sequence and covers common failure cases.

The instructions target Godot 4.7-stable. Set `GODOT_PATH` and `GODOT_CONSOLE_PATH` to use custom engine locations; concurrent runs should isolate data and config directories with `XDG_DATA_HOME` and `XDG_CONFIG_HOME`. Keep GPU-related calls on the main thread, since secondary-thread calls can stall or deadlock. Headless exports also depend on a completed resource import, so UID and compression checks can fail if that step is skipped.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-builder -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-builder/SKILL.md

## When to use it
- turn a glTF asset into a scene with collision geometry
- bake CSG levels into static geometry before NavMesh generation
- prepare a Godot project for CI exports
- validate resource imports and compression settings

## Example prompts
- Process this glTF scene and generate collision geometry using the skill's workflow.
- Optimize this CSG level and prepare its geometry for NavMesh baking.
- Prepare the Godot project for a headless CI export and validate its imports.

## Similar
- [godot-export](https://affpapa.org/en/nevibecode/skills/godot-export.md) — skill · 12200 installs
- [godot-gdscript-headless-testing](https://affpapa.org/en/nevibecode/skills/godot-gdscript-headless-testing.md) — skill · 9300 installs
- [scenario-godot-performance-export](https://affpapa.org/en/nevibecode/skills/scenario-godot-performance-export.md) — skill · 452 installs
- [scenario-godot-pipeline-automation](https://affpapa.org/en/nevibecode/skills/scenario-godot-pipeline-automation.md) — skill · 444 installs
- [godot-ui](https://affpapa.org/en/nevibecode/skills/godot-ui.md) — skill · 2700 installs
- [godot-asset-generator](https://affpapa.org/en/nevibecode/skills/godot-asset-generator.md) — skill · 1000 installs

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 100 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
