running-headless-godot

Automates Godot 4.2+ headless CLI commands, exports, and scene edits with log capture and XDG variable management.

11|2|Updated May 7, 2026
One-click install
npx skills add https://github.com/abagames/agentic-gamedev-skills --skill running-headless-godot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: running-headless-godot
Source: https://github.com/abagames/agentic-gamedev-skills/tree/main/.agents/skills/running-headless-godot
Command: npx skills add https://github.com/abagames/agentic-gamedev-skills --skill running-headless-godot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines headless Godot development by ensuring reproducibility and consistency in workflows, such as CLI commands, exports, and tests.

Core Features & Use Cases

  • Headless Workflow Automation: Executes Godot CLI commands, handles exports, and performs script-based scene edits and tests without a GUI.
  • Log Capture and Analysis: Captures logs for debugging and tracking issues in headless mode.
  • Project Localization: Sets up project-local XDG variables to avoid CI/sandbox write failures.
  • Smoke and Logic Tests: Provides templates for smoke and logic tests to verify the functionality of Godot projects.
  • Use Case: Ideal for developers who need to automate repetitive tasks in Godot development, such as testing headless builds or setting up consistent environments for continuous integration.

Quick Start

Run the 'running-headless-godot' skill to execute a Godot CLI command in headless mode for your project.

Frequently Asked Questions about running-headless-godot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate headless Godot CLI commands for testing and exports?

Automating headless Godot CLI commands involves executing tasks like exports and script-based scene edits without a GUI to ensure reproducibility. This approach captures logs for debugging and sets project-local XDG variables to prevent write failures in continuous integration environments.

What is headless Godot development used for?

Headless Godot development is used to execute CLI commands, handle exports, and perform script-based scene edits without a graphical interface. It ensures consistent environment setup and reproducibility, making it ideal for continuous integration and automated project validation.

Why does Godot fail to write files during headless CI tests?

Godot may fail to write files during headless CI tests due to sandbox write restrictions. Setting up project-local XDG variables ensures the headless environment has the correct permissions, avoiding these write failures and maintaining consistent behavior.

How do I run smoke and logic tests in a Godot project?

Running smoke and logic tests in a Godot project is done by executing script-based tests in headless mode. This validates project functionality and captures logs for issue tracking, ensuring consistent behavior during continuous integration workflows.

Does Godot 4.2 support headless workflow automation for CLI commands?

Yes, Godot 4.2 and above supports headless workflow automation for CLI commands, exports, and script-based scene edits. This ensures reproducible development environments and allows for automated testing without requiring a graphical interface.

What is the best way to capture logs in headless Godot mode?

The best way to capture logs in headless Godot mode is by using an automated workflow that executes CLI commands and systematically records output. This allows for effective debugging and issue tracking during continuous integration and project validation.