# godot-debugging

Helps an agent investigate Godot errors, crashes, and unexpected behavior. Use it when a project needs a focused diagnosis of GDScript or scene issues.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 375 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-debugging/SKILL.md
- Updated: 2025-11-09
- HTML: https://affpapa.org/en/nevibecode/skills/godot-debugging

## What it does

This skill gives an agent practical guidance for reading Godot parser and runtime errors, scene-tree failures, signal problems, and resource-loading issues. It covers causes such as missing node paths, null references, invalid array indexes, duplicate signal connections, and changes made while physics queries are being processed.

The skill can work with `Read`, `Write`, `Edit`, `Glob`, `Grep`, `Bash`, and `mcp__godot__*` tools. It directs the agent to inspect project files and suggest GDScript changes. For operations triggered during physics callbacks, its guidance uses deferred calls such as `call_deferred`; node access is checked before methods or properties are used.

The optional-chaining example is tied to Godot 4.2 and later, so that detail should not be applied to older versions.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Zate/cc-godot --skill godot-debugging -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-debugging/SKILL.md

## When to use it
- trace a GDScript parser error
- locate the source of a null-node failure
- verify a scene-tree node path
- repair a signal and its callback signature
- guard an array access against an invalid index

## Example prompts
- Inspect the current Godot project and diagnose the GDScript error, then suggest a fix.
- Find why `Node not found` appears for this path and check the related scene files.
- Review this signal connection and explain why the callback receives the wrong arguments.

## Similar
- [godot-debugging-profiling](https://affpapa.org/en/nevibecode/skills/godot-debugging-profiling.md) — skill · 457 installs
- [godot-nodes-scenes](https://affpapa.org/en/nevibecode/skills/godot-nodes-scenes.md) — skill · 6700 installs
- [godot-resources](https://affpapa.org/en/nevibecode/skills/godot-resources.md) — skill · 6500 installs
- [godot-ui-theming](https://affpapa.org/en/nevibecode/skills/godot-ui-theming.md) — skill · 617 installs
- [godot-prompter](https://affpapa.org/en/nevibecode/plugins/godot-prompter.md) — plugin · ★ 877
- [godot-mcp](https://affpapa.org/en/nevibecode/mcp/tomyud1-godot-mcp.md) — MCP server · ★ 445

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