CommunityProgramación y desarrollogithub.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.

¿Qué es 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.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EL4CTEO/godot-skills/tree/main/skills/godot-core

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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.

Skills relacionados