project-sync

Zycroft's avatarfrom Zycroft

Sync GameGen SceneLayout from DynamoDB to Godot .tscn files. Exports current layout without AI parsing.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025
[Developer Tools]

When & Why to Use This Skill

This Claude skill automates the synchronization of GameGen scene layouts from DynamoDB directly into Godot 4.x project files (.tscn). It streamlines the game development pipeline by exporting current layouts without manual AI parsing, ensuring that visual properties like background colors, borders, and corner radii are accurately preserved and updated within the Godot engine.

Use Cases

  • Rapidly syncing UI and scene layout updates from a cloud-based DynamoDB to a local Godot project during iterative development.
  • Automating the generation of Godot 4.x compatible .tscn files to maintain visual fidelity with GameGen design specifications.
  • Updating existing Godot project configurations and scene hierarchies efficiently without the need for manual data entry or re-triggering full AI generation workflows.
nameproject-sync
descriptionSync GameGen SceneLayout from DynamoDB to Godot .tscn files. Exports current layout without AI parsing.
allowed-toolsRead, Write, Bash(python3:*), Glob, Grep, mcp__dynamodb__get_item, mcp__dynamodb__scan_table

Project Sync Skill

Syncs GameGen scene layouts from DynamoDB to Godot project files.

What This Skill Does

  1. Reads SceneLayout from DynamoDB (not AI prompts)
  2. Generates .tscn files with proper Godot 4.x format
  3. Writes to Godot project at the configured path
  4. Preserves styling (background colors, borders, corner radius)

This is the frequent sync operation used during development. For initial project setup from AI Game Design, use push-design instead.

Usage

Ask Claude to:

  • "Sync project 2 to Godot"
  • "Export GameGen layout to Godot"
  • "Update Godot project from DynamoDB"
  • "project-sync for project 3"

Command Line

cd .claude/skills/project-sync/scripts

# Sync project to Godot
python3 sync.py --project-id 2

# Dry run to preview output
python3 sync.py --project-id 2 --dry-run

# Custom output directory
python3 sync.py --project-id 2 --output-dir /path/to/godot/project

Data Flow

DynamoDB (SceneLayout) → project-sync → Godot (.tscn files)

DynamoDB Tables Used

Table Keys Data
Projects ID (N) Project name, GodotProjectPath
SceneLayout projectID (N) Scene hierarchy (sceneRoot)

Generated Output

Scene File (.tscn)

[gd_scene load_steps=5 format=3]

[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_MenuBar_1"]
bg_color = Color(0.145, 0.145, 0.145, 1.000)
...

[node name="Root" type="PanelContainer"]
theme_override_styles/panel = SubResource("StyleBoxFlat_Root_1")

[node name="MenuBar" type="PanelContainer" parent="Root/ScreenStack"]
layout_mode = 2
theme_override_styles/panel = SubResource("StyleBoxFlat_MenuBar_1")

Project Config (project.godot)

[application]
config/name="MyGame"
run/main_scene="res://Scenes/Main.tscn"

Styling Support

Style properties from GameGen are exported:

  • backgroundColor → StyleBoxFlat bg_color
  • borderColor → StyleBoxFlat border_color
  • borderWidth → StyleBoxFlat border_width_*
  • cornerRadius → StyleBoxFlat corner_radius_*

Default styles are applied per panel type:

  • MenuBar/StatusBar: #252525
  • Toolbars: #2a2a2a
  • PlaySpace: #1e1e1e
  • Dialogs: Transparent
  • push-design: Initial project setup from AI Game Design (infrequent)
  • project-importer: Import Godot changes back to DynamoDB (reverse sync)