Godot GDScript headless testing (4.x)

Run GDScript test suites from the command line with `godot --headless`, using a SceneTree/MainLoop runner script that exits non-zero on failure so CI can gate merges. Use when a Godot project needs unit tests without opening the editor, when wiring a CI job (GitHub Actions or similar) that must fail the build on a failing `.gd` test, or when a `godot --headless` invocation hangs, opens a window, or exits 0 despite failed assertions.

Skill name

godot-gdscript-headless-testing

Install

npx skills add gamedev-skills/awesome-gamedev-agent-skills

Installs every skill in the collection; the router loads godot-gdscript-headless-testing when your request matches it.

Skill source

Read the full playbook in skills/godot/godot-gdscript-headless-testing/SKILL.md.

Related skills

godot-2d-movement, godot-3d-essentials, godot-animation, godot-audio, godot-csharp, godot-export, godot-gdscript, godot-multiplayer