Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a claude-code
Open on GitHub

What 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.godot or engine.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.godot and 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-code

2Manually: put the files in place

~/.claude/skills/godot-version-migration/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/godot-version-migration/

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.

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set100

The whole set →
godot-genre-shooter-fps godot-genre-shooter-fps — a Godot FPS skill covering mouse look, movement physics, hitscan fire, recoil, weapon motion, and server-checked hit handling. CX Codex +1 296installs godot-game-loop-time-trial godot-game-loop-time-trial is a Claude Code skill for Godot 4 racing trials, with ordered checkpoint validation, lap timing, and ghost playback. CX Codex +1 294installs godot-agent-vision godot-agent-vision — a skill that gives agents eyes in Godot projects: cross-platform screenshot capture, WebP encoding, and visual review scored by a taste receptor system. Use when agents need to see UI, assets, or the editor. CX Codex +1 287installs godot-monte-carlo-balancer The godot-monte-carlo-balancer skill audits Godot balance with Monte Carlo simulations, economy checks, and parameter search. Use it to find unfair levels, farm exploits, and curve problems. CX Codex +1 268installs godot-builder godot-builder is a Claude Code skill that automates Godot CLI workflows for scene creation, 3D asset processing, and CI exports, including headless tasks. CX Codex +1 268installs godot-ai-navigation godot-ai-navigation is a skill that helps choose Godot navigation architecture for agents, including enemies and crowds. CX Codex +1 242installs godot-analyst The godot-analyst skill reviews Godot 4.7+ architecture, dependency structure, and scalability, then turns the findings into a scored certification. CX Codex +1 242installs bevy-master bevy-master is a Claude Code skill that guides Bevy game setup and ECS design. It points to a more focused skill for tasks such as physics, input, or testing. CX Codex +1 114installs

Project sponsors

Companies that keep this analytics open