godot-version-migration — скилл для Claude Code: миграция версий Godot
Скилл godot-version-migration ведёт проект по лестнице версий Godot по одной ступени: с 1.x и 2.x до 3.x, потом мост 3→4 и минорные шаги до 4.7.
LGPL-3.0 190 установок ★ 983 обновлён 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a claude-codeЧто делает godot-version-migration
Скилл определяет эру проекта по project.godot (config_version, config/features) или по старому engine.cfg и выдаёт маршрут: 1.x и ранние 2.x, затем 2→3, остановка на последней 3.x, мост 3→4 и дальше лестница минорных версий до 4.7.
Шаги жёсткие. Из 4.x за проход берётся ровно один шаг current + 0.1, после каждого — открыть проект в новом редакторе и поиграть. Заметки по подсистемам лежат в references/<topic>.md, грузить их все сразу не нужно: только те, что есть в проекте. Скрипт sync_godot_version_migration.py --all обновляет зеркала этих заметок.
Конвертер 3→4 своих копий не делает, поэтому без полного бэкапа его не запускают. Смена формата меша на 4.1→4.2 через «Restart & Upgrade» тоже требует чистого состояния в VCS. Для высокоуровневого мультиплеера сервер и клиент держат на одной минорной версии: протокол SceneMultiplayer меняется между 4.2 и 4.3.
Какие задачи решает
- перевести проект с Godot 3 на 4.0 без пропуска обязательной остановки на 3.x
- найти ломающие изменения для подсистем, которых касается конкретный минор
- определить версию движка по
project.godotили старомуengine.cfg - расписать лестницу 4.0 → 4.7 с плейтестом после каждого шага
- согласовать версии сервера и клиента перед апгрейдом мультиплеера
Примеры запросов агенту
- Определи версию Godot по
project.godotи распиши маршрут миграции до 4.7 - У нас проект на 4.1 — какие шаги нужны до 4.7 и какие заметки по 2D-физике читать?
- Составь план перехода с 3.x на 4.0 и скажи, что сохранить перед запуском конвертера
Как установить godot-version-migration
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a claude-code2Вручную: положить файлы
~/.claude/skills/godot-version-migration/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/godot-version-migration/
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a codex2Вручную: положить файлы
.agents/skills/godot-version-migration/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a cursor2Вручную: положить файлы
.cursor/skills/godot-version-migration/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-version-migration2Вручную: положить файлы
.github/skills/godot-version-migration/SKILL.md1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a gemini-cli2Командой платформы
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-version-migrationВручную: положить файлы
.devin/skills/godot-version-migration/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о godot-version-migration
Как установить godot-version-migration в Claude Code?
Выполните npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a claude-code. Файл скилла появится в ~/.claude/skills/godot-version-migration/SKILL.md.
Что делает godot-version-migration?
Разводит апгрейд движка по шагам: определяет эру проекта, подставляет официальный гайд для целевой версии, тянет заметки только по нужным подсистемам и проверяет результат в редакторе.
Можно ли прыгнуть с 4.0 сразу на 4.7?
Нет. Скилл берёт по одному минору с плейтестом между ними, потому что у каждого перехода свой гайд и свои поломки.