Godot Skill

A skill for Codex and Claude Code on Godot 4: build, edit, run and debug projects, lint, test and export

  • 255 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • The skill runs Godot and its own Python scripts in the project folder
  • It edits scene, resource and script files of the game
  • It can move project files and change resource paths
All reasons and checks

haxqer/godot-skill

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/godot-skill

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The skill runs Godot and its own Python scripts in the project folder
  • It edits scene, resource and script files of the game
  • It can move project files and change resource paths

This is third-party code. Review the repository files before installing.

What it does

Godot Skill is a skill for Godot 4.x, verified on version 4.7. The agent creates a project from scratch, edits scenes, UI and resources without the editor, and writes `.gd`, `.tscn`, `.tres` and `.gdshader` files. Before typing a class, method or constant name it checks the installed engine's reference with the `api_lookup.py` script, and a wrong name gets the nearest real ones back. The bundle ships GDScript templates (player, enemy, health, inventory, dialogue, save), recipes for tile levels and ASCII maps, pixel art and sound: the skill draws sprites from ASCII and synthesizes effects and music. For verification there is a linter for GDScript, scenes and shaders that runs without Godot, a smoke run of every scene with input fuzzing, unit tests and export setup. Check results read as text: node trees, UI layout and object placement, so the agent needs no vision.

Who it is for. Godot 4 game developers who want an agent to build scenes, UI and levels and verify the result right away.

Good fit when

  • You want to build a small game from scratch, such as a platformer or a wave shooter, and check that the level is winnable
  • An old Godot 3 project must move to version 4 and its outdated calls found
  • A game crashes on launch or in individual scenes and the agent traces the cause from logs and a smoke run
  • You need sound effects and pixel sprites and no image generator is at hand

Not a fit when

  • You want to drive a live Godot editor: the catalog has MCP servers for that
  • The project is in Unity or Unreal: the skill knows only Godot
  • You need an engine version other than 4.x: the skill targets 4.7 and is compatible with 4.x

Example request

Build a small Godot 4 platformer with a player, a tile level and a pause menu, then run a playthrough scenario and show the result

Limitations

Most checks need Godot itself: tests that launch the engine skip themselves if it is missing. The scripts are written in Python, render checks need a working frame output, and on a headless CI server Xvfb and software OpenGL are installed. The skill is aimed at Codex, with agents/openai.yaml in the bundle, and for Claude Code you copy it into the skills directory. The repository's last commit is from September 2026.

How to disable. Delete the godot folder from the agent skills directory and restart the session. The skill does not change your game projects unless you ask.

FAQ

How do I install the skill?

Copy `skill/godot` into the agent's skills directory so it is named `godot`, or unzip `godot.zip` from a release: the archive already has a top-level `godot/` folder.

Which Godot versions are supported?

The skill is designed for Godot 4.7 and compatible with 4.x. For Godot 3 projects there is a migration reference and a check for outdated calls.

Do I need Godot installed?

Yes for running the project, tests and export. The linter for GDScript, scenes and shaders works without the engine.

How does the skill check the UI without vision?

It reads the result as text: node trees, UI layout and object placement, and a smoke run opens every scene and feeds random input.

How does the skill handle moving files?

It moves project files with `move_resource.py` in place of `mv`, with a dry-run mode, so `res://` paths stay intact.

Discussion

No questions or reviews yet.

Skills

GD Agentic Skills

gd-agentic-skills

Skills for Godot 4: the Orchestrator master skill and narrow skills by area. A strict warning: never install with the --all flag, only one at a time

SkillExtended access959Repository stars

The $gamestudio skill for Codex guides a game from prototype to release, bringing the needed game studio roles into one agent.

SkillMinimal access104Repository stars

Godot MCP Enhanced reads, edits, runs and verifies Godot 4.5 to 4.7 projects: scenes, scripts, UI and tests with path protection.

MCP serverBroad access104Repository stars
Needs a VPN

Autonomous game development for Godot, Bevy and Babylon.js: the agent writes code, generates assets, runs the engine and judges the result from the game

SkillBroad access7.3KRepository stars

GodotMaker takes a game idea to a working 2D Godot prototype: agents plan, write code and tests, then verify the result.

CLIBroad access562Repository stars

A set of game-dev skills for AI agents with a router that picks the right ones for the engine and task

SkillMinimal access8.4KRepository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
Godot Skill (this card)no255
Godot MCPnonot required6,620an MCP server to the Godot editor rather than a bundle of workflows
Godot AIyesAPI key3,509drives a live Godot editor through MCP

README in short

The repository keeps the working skill in `skill/godot` and the supporting pieces around it: a packaging script, tests, a Docker image for Linux checks and CI. A tagged release attaches the `godot.zip` archive. Installation comes down to copying the folder into a skills directory.

README badge

Report a problem