Godot
Work from the target project's actual Godot version, project settings, addons, and export presets. Preserve project conventions rather than imposing a generic scene architecture.
Preflight
- Read repository instructions and inspect
project.godot, export_presets.cfg, installed addons, and the existing test layout.
- Resolve the Godot executable and verify its version before choosing commands or APIs.
- Determine the required verification level:
- GdUnit4 for unit, component, and in-engine scene tests;
- PlayGodot for external end-to-end automation, screenshots, or input simulation;
- a real exported build when behavior depends on platform or browser packaging.
- Do not claim real-render, input, export, or deployment success from static checks alone.
Test and implement
- For GdUnit4 setup, test layout, and runner commands, read references/gdunit4-quickstart.md.
- For scene input simulation, read references/scene-runner.md.
- For assertion syntax, read references/assertions.md only when writing or repairing assertions.
- For PlayGodot installation and external automation, read references/playgodot.md. Confirm the required custom Godot build exists before selecting this path.
Prefer the project's existing runner. A common GdUnit4 command is:
godot --headless --path . -s res://addons/gdUnit4/bin/GdUnitCmdTool.gd --run-tests
Use the bundled helpers by resolving them relative to this skill directory:
scripts/validate_project.py for project preflight;
scripts/run_tests.py for repeatable test execution;
scripts/export_build.py for exports;
scripts/parse_results.py for machine-readable test results.
Inspect helper options before running them, and do not overwrite a project's established commands when its own scripts are authoritative.
Export and deployment
- Read references/deployment.md when creating or changing export presets or deployment behavior.
- Export into the project's designated build directory and inspect the produced artifact.
- For web builds, serve the export and exercise it in a browser; verify asset loading, input, viewport behavior, console errors, and any required cross-origin isolation.
- Read references/ci-integration.md when changing CI rather than copying an unverified workflow example.
- Treat production deployment as a separate authorization boundary. After an authorized deployment, verify the live target rather than stopping at a successful CLI exit.
Finish with the Godot version, tests or runtime checks performed, produced artifact or deployment state, and any behavior that remains unverified.
1---
2name: godot
3description: Develop, test, automate, export, and deploy Godot 4.x games. Use when working with Godot projects, GDScript, GdUnit4, PlayGodot, project exports, or Godot CI and deployment.
4metadata:
5 source: https://skillmd.com/skills/randroids-dojo/godot
6---
7
8# Godot
9
10Work from the target project's actual Godot version, project settings, addons, and export presets. Preserve project conventions rather than imposing a generic scene architecture.
11
12## Preflight
13
141. Read repository instructions and inspect `project.godot`, `export_presets.cfg`, installed addons, and the existing test layout.
152. Resolve the Godot executable and verify its version before choosing commands or APIs.
163. Determine the required verification level:
17 - GdUnit4 for unit, component, and in-engine scene tests;
18 - PlayGodot for external end-to-end automation, screenshots, or input simulation;
19 - a real exported build when behavior depends on platform or browser packaging.
204. Do not claim real-render, input, export, or deployment success from static checks alone.
21
22## Test and implement
23
24- For GdUnit4 setup, test layout, and runner commands, read [references/gdunit4-quickstart.md](references/gdunit4-quickstart.md).
25- For scene input simulation, read [references/scene-runner.md](references/scene-runner.md).
26- For assertion syntax, read [references/assertions.md](references/assertions.md) only when writing or repairing assertions.
27- For PlayGodot installation and external automation, read [references/playgodot.md](references/playgodot.md). Confirm the required custom Godot build exists before selecting this path.
28
29Prefer the project's existing runner. A common GdUnit4 command is:
30
31```bash
32godot --headless --path . -s res://addons/gdUnit4/bin/GdUnitCmdTool.gd --run-tests
33```
34
35Use the bundled helpers by resolving them relative to this skill directory:
36
37- `scripts/validate_project.py` for project preflight;
38- `scripts/run_tests.py` for repeatable test execution;
39- `scripts/export_build.py` for exports;
40- `scripts/parse_results.py` for machine-readable test results.
41
42Inspect helper options before running them, and do not overwrite a project's established commands when its own scripts are authoritative.
43
44## Export and deployment
45
461. Read [references/deployment.md](references/deployment.md) when creating or changing export presets or deployment behavior.
472. Export into the project's designated build directory and inspect the produced artifact.
483. For web builds, serve the export and exercise it in a browser; verify asset loading, input, viewport behavior, console errors, and any required cross-origin isolation.
494. Read [references/ci-integration.md](references/ci-integration.md) when changing CI rather than copying an unverified workflow example.
505. Treat production deployment as a separate authorization boundary. After an authorized deployment, verify the live target rather than stopping at a successful CLI exit.
51
52Finish with the Godot version, tests or runtime checks performed, produced artifact or deployment state, and any behavior that remains unverified.