project-importer

Import Godot projects into GameGen's DynamoDB-ready scene format.

Updated Dec 28, 2025
One-click install
npx skills add https://github.com/Zycroft/GameGen --skill project-importer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-importer
Source: https://github.com/Zycroft/GameGen/tree/main/.claude/skills/project-importer
Command: npx skills add https://github.com/Zycroft/GameGen --skill project-importer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill imports an entire Godot project (all .tscn scenes and .gd scripts) and converts it into GameGen's DynamoDB-ready scene format, automating the translation and flagging programmatic changes for quick review.

Core Features & Use Cases

  • Automated project import: Scans a Godot project for scenes and scripts and builds a unified GameGen structure.
  • Programmatic change detection: Analyzes GDScript to flag runtime position/size modifications.
  • DynamoDB-ready output: Produces a consolidated root with all scenes ready for a database upload.

Quick Start

Run the importer on a Godot project to convert it into GameGen format. Example commands:

  • python .claude/skills/project-importer/scripts/import_godot_scene.py /path/to/project --project-id 1
  • python .claude/skills/project-importer/scripts/import_godot_scene.py /path/to/project --project-id 1 --dry-run
  • python .claude/skills/project-importer/scripts/import_godot_scene.py /path/to/project --project-id 1 --output scenes.json