setup-godot-project

Configures GUT testing, Just recipes, warnings, and version-control guardrails in Godot projects.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/bbenefield89/skills --skill setup-godot-project-bbenefield89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-godot-project
Source: https://github.com/bbenefield89/skills/tree/main/skills/setup-godot-project
Command: npx skills add https://github.com/bbenefield89/skills --skill setup-godot-project-bbenefield89

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Setting up a Godot project with consistent testing, validation, and version-control infrastructure is repetitive and error-prone, and existing projects often accumulate outdated or conflicting setup artifacts that need careful reconciliation. ## Core Features & Use Cases - Infrastructure Reconciliation: Discovers the current state of GUT, Just, Git, warnings, and ignore rules, then classifies each step as missing, current, legacy, customized, or conflicting before proposing changes. - GUT Test Framework Setup: Installs a compatible pinned GUT release, enables the editor plugin, and adds smoke tests plus Just recipes for import, focused tests, full tests, runtime checks, and aggregate validation. - Legacy Migration: Detects and migrates or removes recognized version-1 setup policy documents and AGENTS blocks while preserving user customizations. - Use Case: Point the skill at a directory containing project.godot to get an approval-gated plan that installs GUT, merges Justfile recipes, applies strict GDScript warnings, and verifies everything with just validate. ## Quick Start Use $setup-godot-project to reconcile GUT, Just, validation, warnings, and version-control infrastructure in this Godot project.

Frequently Asked Questions about setup-godot-project

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

FAQPage Schema
How do I set up GUT testing in a Godot project?

Run the setup workflow on a directory containing project.godot. It detects your exact Godot version, selects a compatible published GUT release, installs addons/gut, enables the editor plugin, and adds a smoke test verified with just test tests/test_gut_setup.gd.

How do I add Just validation recipes to a Godot project?

The skill merges import, test, test-all, runtime, and validate recipes into your existing Justfile, preserving unrelated recipes and variables. If multiple distinct Justfiles exist, it treats ownership as a hard conflict and asks before proceeding.

Does this work with an existing Godot project that already has configuration?

Yes. Each setup step is classified independently as missing, current, recognized legacy, compatible customization, or hard conflict. Existing customizations are preserved, and only unambiguous missing behavior is proposed after your explicit approval.

What happens if Just is not installed on my system?

Discovery distinguishes available, found-but-not-executable, and missing states. Installation is only proposed when no executable is found, with the exact package manager command presented for approval; PATH changes always require separate explicit consent.

Will it overwrite my customized docs or AGENTS.md blocks?

No. Recognized version-1 generated files are deleted only when they match canonical content exactly after line-ending normalization. Any modification is treated as user customization, and you are asked whether to keep, consolidate, or remove it.

Can it create gameplay scenes or commit changes automatically?

No. It configures only universal infrastructure and never creates placeholder scenes, gameplay folders, or GitHub Actions. It never commits or pushes unless you explicitly instruct it, and an explicit do-not-commit instruction always wins.