# godot-development

A skill that lets your coding agent build Godot scenes, add nodes and write GDScript instead of walking you through the editor by hand.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 installs · ★ 20
- Author: Zate
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Zate/cc-godot/tree/HEAD/plugins/gd/skills/godot-dev/SKILL.md
- Updated: 2025-11-09
- HTML: https://affpapa.org/en/nevibecode/skills/godot-development

## What it does

The skill loads the agent with Godot knowledge: the scene tree, 2D and 3D node types, `_ready` and `_physics_process`, and a sensible layout for `scenes`, `scripts` and `assets`. Node references and input handling come with GDScript snippets.

It also wires in the Godot MCP tools. The agent can open the editor, run the project, pull console output and errors, create a `.tscn`, attach nodes, load a texture into a `Sprite2D`, and save the scene. Separate calls cover the engine version and UID references in Godot 4.4+.

Because the skill allows `mcp__godot__*`, a connected Godot MCP server is the prerequisite. Without it you get file reads and edits only — no scene creation, no project runs. Install is a single `npx skills` command, and the file lands in the skills folder of whichever platform you pick.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Zate/cc-godot --skill godot-development -a claude-code
```
```bash
npx skills add Zate/cc-godot --skill godot-dev -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/godot-dev/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/godot-dev/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Zate/cc-godot --skill godot-dev -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/godot-dev/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Zate/cc-godot --skill godot-dev -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-dev/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Zate/cc-godot godot-dev
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-dev/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Zate/cc-godot --skill godot-dev -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Zate/cc-godot --path plugins/gd/skills/godot-dev
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/godot-dev/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Zate/cc-godot --skill godot-dev -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Zate/cc-godot/tree/HEAD/plugins/gd/skills/godot-dev/SKILL.md

## When to use it
- build a character scene with a sprite and collision shape
- find out why a node ignores input
- lay out project folders for scenes, scripts and assets
- run the game and read the errors it prints
- write movement in `_physics_process` without digging through docs

## Example prompts
- Create a player scene with `CharacterBody2D` as root, plus `Sprite2D` and `CollisionShape2D` children
- Run the project and show me the console output
- Add a `Timer` node set to two seconds inside `main.tscn`

## Similar
- [orbit-card](https://affpapa.org/en/nevibecode/skills/orbit-card.md) — skill · 10000 installs
- [cad](https://affpapa.org/en/nevibecode/skills/cad.md) — skill · 14000 installs
- [step-parts](https://affpapa.org/en/nevibecode/skills/step-parts.md) — skill · 11200 installs
- [sdf](https://affpapa.org/en/nevibecode/skills/sdf.md) — skill · 10500 installs
- [urdf](https://affpapa.org/en/nevibecode/skills/urdf.md) — skill · 10500 installs
- [hatch-pet](https://affpapa.org/en/nevibecode/skills/hatch-pet.md) — skill · 3300 installs

From the same set: [zate/cc-godot](https://affpapa.org/en/nevibecode/by/zate/cc-godot.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md