godot-builder — Claude Code skill: features and installation
godot-builder is a Claude Code skill that automates Godot CLI workflows for scene creation, 3D asset processing, and CI exports, including headless tasks.
LGPL-3.0 268 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-builder -a claude-codeWhat godot-builder 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.
What it helps with
- 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 for the agent
- 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.
How to install godot-builder
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-builder -a claude-code2Manually: put the files in place
~/.claude/skills/godot-builder/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-builder/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-builder -a codex2Manually: put the files in place
.agents/skills/godot-builder/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-builder -a cursor2Manually: put the files in place
.cursor/skills/godot-builder/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-builder2Manually: put the files in place
.github/skills/godot-builder/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-builder -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-builderManually: put the files in place
.devin/skills/godot-builder/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-builder -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-builder
How do I install godot-builder in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-builder -a claude-code. The skill file is at ~/.claude/skills/godot-builder/SKILL.md.
What does godot-builder do?
It provides ordered CLI workflows for Godot asset processing, procedural level optimization, and CI export preparation.
Which Godot version does godot-builder target?
Its workflows target Godot 4.7-stable. Use GODOT_PATH and GODOT_CONSOLE_PATH to set custom engine locations.