# Migrate Godot 3 Projects to Godot 4

Godot 3 projects often fail after upgrading because GDScript syntax and engine APIs changed. This skill maps common Godot 3 patterns to Godot 4 replacements.

## Install

```bash
npx skillstore add sickn33/godot-4-migration
```

## Metadata

- Status: approved
- Slug: sickn33-godot-4-migration
- Skillstore revision: r2
- Version status: missing
- Tree hash: 91bb638eb23b64003436583790a9b15256e27aaea55afa4db0cd8af780eba051
- Author: sickn33
- GitHub username: sickn33
- License: MIT
- Repository: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/godot-4-migration
- Ref: 88a8e9a07f4c54ab105c1c41b6267c287146b07b
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/sickn33-godot-4-migration
- Manifest: https://skillstore.pages.dev/api/skills/sickn33-godot-4-migration/manifest

## Capabilities

- Converts legacy export, onready, and tool declarations to Godot 4 annotations.
- Explains inline setter and getter syntax in GDScript 2.0.
- Replaces Tween node workflows with create\_tween patterns.
- Updates string-based signal connections to callable connections.
- Shows typed arrays and await-based coroutine syntax.

## Use Cases

- Upgrade an Existing Game: Map common GDScript syntax and API changes before opening a Godot 3 game in Godot 4.
- Teach Godot 4 Syntax: Compare old and new patterns for annotations, properties, signals, tweens, typed arrays, and coroutines.
- Review a Migration: Check converted scripts for outdated patterns and identify areas that still require runtime validation.

## Prompt Templates

### Convert Basic Declarations

```
Convert these Godot 3 declarations to Godot 4 annotations: [paste declarations]. Explain each change briefly.
```

### Migrate Tween Logic

```
Rewrite this Godot 3 Tween logic for Godot 4: [paste code]. Preserve timing, parallel behavior, and target properties.
```

### Update Signals and Coroutines

```
Migrate these signal connections and coroutine calls to Godot 4: [paste code]. Identify behavior that needs runtime testing.
```

### Audit a Full Script

```
Review this Godot 3 script for Godot 4 migration issues: [paste script]. Prioritize changes across syntax, typing, tweens, signals, and coroutines.
```

## Limitations

- Does not provide an automated project migration script.
- Does not cover every renamed engine API, node, or resource format.
- Requires testing in the target Godot 4 version.
- Examples cover GDScript and do not address C\# migration.

## Best Practices

- Migrate one subsystem at a time and test scenes after each change.
- Add explicit types where they improve compatibility and editor diagnostics.
- Verify renamed nodes, properties, signals, and resources against the target Godot documentation.

## Anti Patterns

- Do not apply syntax replacements without checking behavior changes.
- Do not assume every Godot 3 API has a direct Godot 4 equivalent.
- Do not complete a migration without running scenes and reviewing editor errors.

## Security Audit

- Audited at: 2026-07-24T00:30:06.576\+00:00
- Summary: All 33 external-command detections are Markdown backticks used for Godot names or fenced GDScript examples; none invokes a shell. The reconnaissance detection is an ordinary Godot error message, and no prompt injection or malicious intent appears in SKILL.md.

## Stats

- Views: 111
- Downloads: 12
- Favorites: 0
- Popularity score: 0