godot-version-migration — Claude Code skill: Godot version upgrades
godot-version-migration walks a Godot project up the version ladder one release at a time, from 1.x and 2.x through the 3→4 bridge and on to 4.7.
LGPL-3.0 190 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a claude-codeWhat godot-version-migration does
The skill reads project.godot (config_version, config/features) or the older engine.cfg to place the project in an era, then returns a route: legacy 1.x and early 2, the 2→3 step, a stop on the last 3.x release, the 3→4 bridge, then the 4.x minors.
Every 4.x hop is one current + 0.1 move. Open the project in the new editor and playtest before the next one. Per-subsystem notes sit in references/<topic>.md; load only the ones your project uses. sync_godot_version_migration.py --all refreshes those mirrored notes.
The 3→4 converter writes no backup of its own, so a full copy comes first. The mesh format change on 4.1→4.2 behind “Restart & Upgrade” wants a clean VCS state as well. Keep multiplayer server and client on the same minor: the SceneMultiplayer protocol shifts between 4.2 and 4.3.
What it helps with
- move a Godot 3 project to 4.0 without skipping the 3.x stabilization stop
- find the breaking changes for the subsystems a given minor touches
- pin down the engine era from
project.godotorengine.cfg - plan a 4.0 → 4.7 ladder with a playtest after every hop
- keep multiplayer server and client minors aligned through an upgrade
Example prompts for the agent
- Detect the Godot version from
project.godotand lay out the migration route to 4.7 - We're on 4.1 — which hops do we need, and which 2D physics notes apply?
- Draft the 3.x → 4.0 plan and flag what to back up before the converter runs
How to install godot-version-migration
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a claude-code2Manually: put the files in place
~/.claude/skills/godot-version-migration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-version-migration/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a codex2Manually: put the files in place
.agents/skills/godot-version-migration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a cursor2Manually: put the files in place
.cursor/skills/godot-version-migration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-version-migration2Manually: put the files in place
.github/skills/godot-version-migration/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-version-migrationManually: put the files in place
.devin/skills/godot-version-migration/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-version-migration
How do I install godot-version-migration in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a claude-code. The skill file lands at ~/.claude/skills/godot-version-migration/SKILL.md.
What does godot-version-migration do?
It routes an engine upgrade: work out the era, follow the official guide for the destination release, pull module notes only for the subsystems in the project, then verify in the editor.
Can I jump straight from 4.0 to 4.7?
No. The skill takes one minor per pass with a playtest in between, because each hop carries its own guide and its own breakage.