godot-modernize-gdscript

Migrate GDScript 1.0 code to GDScript 2.0 syntax for Godot 4.x.

3|1|Updated Feb 2, 2026

Search Tags:#migration #refactor #gdscript #godot #typing #gdscript2

Ready to run

npx skills add https://github.com/Asreonn/godot-superpowers --skill godot-modernize-gdscript

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: godot-modernize-gdscript
Source: https://github.com/Asreonn/godot-superpowers/tree/main/mini-skills/godot-modernize-gdscript
Command: npx skills add https://github.com/Asreonn/godot-superpowers --skill godot-modernize-gdscript

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the modernization of GDScript 1.0 to GDScript 2.0 within Godot 4.x projects, enabling reliable migrations with fewer manual edits.

Core Features & Use Cases

Automated syntax modernization: converts yield to await, onready to @onready, export to @export, and setget to the new property syntax.
Optional typing: adds static type hints to improve readability, editor hints, and early error detection.
Use Case: you have a large Godot 3.x project and need to migrate to Godot 4.x with minimal risk and fast iteration.

Quick Start

Run the modernization flow on a Godot project root and review per-file changes before committing; then test the migrated project in the Godot editor to verify behavior.

Frequently Asked Questions about godot-modernize-gdscript

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

FAQPage Schema

How do I migrate GDScript 1.0 to 2.0 for Godot 4.x?▼

To migrate GDScript 1.0 to 2.0, this Skill automates the conversion of Godot 3.x code to modern Godot 4.x syntax across multiple .gd files, transforming yield, onready, export, and setget keywords safely.

What is the best way to convert Godot 3.x yield and setget syntax to GDScript 2.0?▼

Converting Godot 3.x yield and setget syntax to GDScript 2.0 involves replacing yield with await and updating setget to the new property syntax, ensuring modern Godot 4.x behavior is preserved during the migration.

Can I add static typing when migrating GDScript 1.0 code?▼

Yes, you can add optional static typing when migrating GDScript 1.0 code to GDScript 2.0, applying static type hints to improve readability, provide editor hints, and enable early error detection.

Does this GDScript migration approach support dry-run and per-file commits?▼

This GDScript migration approach supports optional dry-run and per-file commits, allowing you to review changes for each .gd file individually before committing to ensure safe transformations across large Godot projects.

How do I handle multiple .gd files when modernizing GDScript for Godot 4?▼

When modernizing GDScript for Godot 4, the Skill operates across a project root to process multiple .gd files, applying per-file commits and preserving original behavior throughout the GDScript 2.0 syntax modernization.