gm-scaffold

Generate Godot project files, install addons, and set up E2E test harness.

511|44|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/RandallLiuXin/GodotMaker --skill gm-scaffold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gm-scaffold
Source: https://github.com/RandallLiuXin/GodotMaker/tree/main/skills/core/gm-scaffold
Command: npx skills add https://github.com/RandallLiuXin/GodotMaker --skill gm-scaffold

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the slow, error-prone setup work of creating a new Godot project with the required baseline structure, end-to-end testing harness, and initial git state.

Core Features & Use Cases

  • Lifetime-once project scaffolding: Creates the foundation for a brand-new Godot project only on fresh projects, preventing accidental rework mid-pipeline.
  • Deterministic directory + scene placeholders: Produces project.godot, base directories, and placeholder scenes (including scenes/main.tscn and scenes/game_world.tscn) via a dedicated project-scaffold skill.
  • Addon installation and validation gating: Installs required addons from .claude/config/addon_versions.json, enables plugins (including godot-e2e), writes e2e/conftest.py, runs the headless/import step, and verifies readiness with tools/check_project.py --build.
  • Local-first git initialization: Ensures an initial git commit exists and includes Godot import metadata so parallel worker worktree isolation can resolve HEAD.

Quick Start

Invoke /gm-scaffold, provide a game name and a 2D or 3D perspective, and wait for the scaffold verification to pass so you can continue with /gm-gdd.

Frequently Asked Questions about gm-scaffold

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

FAQPage Schema
How do I scaffold a new Godot project with an e2e testing harness?

Scaffolding a new Godot project generates base files, installs required addons, writes e2e/conftest.py, and runs headless import validation. This creates a lifetime-once foundation with a ready-to-use E2E test harness for local development.

What's the best way to initialize git for a local-first Godot workflow?

Git initialization for a local-first Godot workflow requires an initial commit including Godot import metadata. This ensures parallel worker worktree isolation can resolve HEAD correctly after the scaffold completes.

Can I use this Godot project scaffolding tool for an existing project?

Godot project scaffolding applies only to fresh-project initialization workflows. It prevents accidental rework mid-pipeline by creating a lifetime-once foundation before design or GDD work begins.

Why does my Godot project need a headless import step during setup?

The headless import step validates project readiness and generates import metadata before the initial git commit. It ensures the scaffold passes the gm-scaffold readiness check via tools/check_project.py --build.

Do I need addon_versions.json to set up a Godot project baseline?

Yes, addon_versions.json provides deterministic inputs for addon installation. The scaffold reads this configuration to install required addons, enable plugins like godot-e2e, and validate the project setup.

What does a Godot project scaffold include for 2D or 3D games?

A Godot project scaffold includes project.godot, base directories, and placeholder scenes like scenes/main.tscn and scenes/game_world.tscn. You provide a game name and 2D or 3D perspective to generate the foundation.