Community코딩 & 개발github.com

godot-core

Start here for any Godot 4.7 task (GDScript or C#/.NET). Exact API lookup from the installed engine, headless run/import/smoke tests, safe scene editing, project inspection, 4.5-4.7 changes and Godot 3 traps, and routing to the specialized godot-* skills. Use for any Godot, .gd, .cs, .tscn or project.godot request.

godot-core란 무엇인가요?

godot-core is a Claude Code agent skill that start here for any Godot 4.7 task (GDScript or C#/.NET). Exact API lookup from the installed engine, headless run/import/smoke tests, safe scene editing, project inspection, 4.5-4.7 changes and Godot 3 traps, and routing to the specialized godot-* skills. Use for any Godot, .gd, .cs, .tscn or project.godot request.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EL4CTEO/godot-skills/tree/main/skills/godot-core

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Godot Core (4.7)

Script paths below are relative to this skill's folder. Sibling skills sit next to it (../godot-csharp/...). All scripts print one compact JSON object. Run them; you don't need to read them. Set GODOT_EXE if the engine isn't found.

Non-negotiables

  1. Never guess an API. Your training data mixes Godot 3, early 4.x and 4.7. Check names, signatures, defaults and the matching C# name before you use them: python scripts/api_lookup.py Class.member, or Class / --search word / @export_range / ProjectSettings.physics/3d/physics_engine. It reads the engine you have installed, so the answer is always correct for that version.
  2. Don't hand-write .tscn/.tres structure. Use scripts/scene_edit.py, which builds scenes through Godot itself. It never saves a half-applied edit. Changing a single property value in a text file is fine.
  3. Verify before you say it's done: run gd_check.py and/or cs_build.py, then run_godot.py smoke, then test_run.py (see the loop below).
  4. Read references/godot3-traps.md before writing code from memory. Read references/whats-new.md whenever a feature might be new (4.5–4.7).

Route to the specialized skill

TaskSkill
GDScript language, typing, signals, await, stylegodot-gdscript
C#/.NET: csproj, partial classes, [Export]/[Signal], interop, marshalinggodot-csharp
Project structure, scenes vs scripts, autoloads, Resources, state machines, savesgodot-architecture
2D: TileMapLayer, Parallax2D, Camera2D, 2D lightsgodot-2d
3D rendering: renderers, lights (AreaLight3D), GI, materials, HDR, importgodot-3d-rendering
Physics: Jolt, CharacterBody, raycasts, layers, ragdollsgodot-physics
UI: Controls, containers, themes, responsive layout, accessibilitygodot-ui
Input: actions, rebinding, gamepads, gyro, touch, VirtualJoystickgodot-input
Animation: AnimationPlayer/Tree, Tween, IK, skeleton modifiersgodot-animation
Shaders, VFX, particles, compositor, stencilgodot-shaders-vfx
Audio: buses, interactive music, 3D audiogodot-audio
Multiplayer, RPC, replication, HTTP, socketsgodot-networking
Profiling, optimization, threading, serversgodot-performance
Export presets, templates, CLI/CI builds, platformsgodot-export-ci
@tool, EditorPlugin, docks, import/export plugins, GDExtensiongodot-editor-tooling
Unit tests (GdUnit4, gdUnit4Net), debugging, logginggodot-testing-debug
VR/AR, OpenXRgodot-xr

Tools

NeedCommand
Engine path, version, .NET or notpython scripts/run_godot.py version
Project summary: renderer, physics, autoloads, input map, C# setuppython scripts/project_inspect.py [DIR]
Scene tree of a .tscn without opening Godotpython scripts/project_inspect.py --scene res://x.tscn [--props]
One project setting / list filesproject_inspect.py --setting display/window/stretch/mode, --files --ext gd,cs
Import assets, build the class_name cachepython scripts/run_godot.py import
Run the game headless for N frames and collect errorspython scripts/run_godot.py smoke [res://scene.tscn] --frames 120
Run an extends SceneTree / MainLoop scriptpython scripts/run_godot.py script tool.gd -- args
Create or edit scenespython scripts/scene_edit.py spec.json (spec format: --help)

Verification loop

  1. GDScript: python ../godot-gdscript/scripts/gd_check.py runs the real parser and analyzer on every .gd file.
  2. C#: python ../godot-csharp/scripts/cs_build.py returns dotnet build errors as file:line CSxxxx. Build before smoke tests, because the engine loads the compiled assembly.
  3. run_godot.py smoke runs the main scene headless. Any errors entry means a runtime problem, such as a null node path or a bad cast.
  4. python ../godot-testing-debug/scripts/test_run.py runs the unit tests when the project has any. For GPU-dependent visuals, ask the user to check the running game. Headless mode doesn't render.

Working with a user's open editor

  • The editor reloads files changed on disk. It asks before reloading a scene with unsaved edits, so tell the user to save before you edit a scene that's open.
  • The .godot/ folder is a cache. Never edit or commit it. Commit *.uid files (4.4+), because they keep references stable when files are renamed.
  • Refer to resources by uid:// or res:// paths. Never use OS paths inside a project.
  • Is a Godot MCP server connected? Use it for live editor state such as the open scene, selection or a running-game screenshot. These scripts are for files, the CLI and verification.

Project facts to check first

Run project_inspect.py and respect what it finds:

  • the renderer (forward_plus, mobile or gl_compatibility), which decides what you may use (see godot-3d-rendering)
  • the 3D physics engine (new 4.6+ projects use Jolt)
  • the stretch mode (new 4.7 projects use canvas_items + expand)
  • whether the project has C#, from csharp in the output: mixed GDScript + C# projects are valid
  • existing autoloads, input actions and folder layout, which you reuse instead of duplicating

References

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬