# godot-ai-navigation

godot-ai-navigation is a skill that helps choose Godot navigation architecture for agents, including enemies and crowds.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 242 installs · ★ 983 repo stars
- Author: thedivergentai
- License: LGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-ai-navigation/SKILL.md
- Updated: 2026-10-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/godot-ai-navigation

## What it does

Not a Godot navmesh tutorial—a decision router for your navigation stack. The skill provides four decision trees: node agent vs server RID (depends on agent count and game type), dynamic baking vs RVO obstacles, navigation layers and links, and retarget policy for chase and patrol states.

Each decision points to a ready-to-use script from the repository. The skill flags common pitfalls: assigning `target_position` every frame (triggers path recalculation spam), synchronous navmesh bake, ignoring `is_target_reachable()`, zero collision radius when avoidance is on, and copying scripts instead of relying on the linked godot-navigation-pathfinding skill.

If godot-navigation-pathfinding is missing, the skill gives a minimal recovery checklist: defer the first target assignment with `call_deferred`, retarget on timer or distance threshold, check `is_target_reachable()` on stall.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-ai-navigation
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-ai-navigation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -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/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-ai-navigation/SKILL.md

## When to use it
- pick NavigationAgent or RID server based on agent count
- stop path recalculation spam during chases
- detect and recover when an agent gets stuck
- set up dynamic navigation for procedurally generated levels
- organize crowd formations without clustering

## Example prompts
- Should I use NavigationAgent or RID server for 200 enemies in 2D
- How do I prevent an agent from getting stuck while chasing the player
- Set up navigation layers so ground enemies walk but flying enemies take the air route

## Similar
- [game-design](https://affpapa.org/en/nevibecode/skills/game-design.md) — skill · 247 installs
- [godot-ui-control](https://affpapa.org/en/nevibecode/skills/godot-ui-control.md) — skill · 13100 installs
- [godot-signals-groups](https://affpapa.org/en/nevibecode/skills/godot-signals-groups.md) — skill · 12300 installs
- [glade-mcp](https://affpapa.org/en/nevibecode/mcp/glade-mcp.md) — MCP server · ★ 204 repo stars
- [spritecook-use-assets-in-godot](https://affpapa.org/en/nevibecode/skills/spritecook-use-assets-in-godot.md) — skill · 773 installs
- [godot-export](https://affpapa.org/en/nevibecode/skills/httpsgithubcomarjun988-godot-export.md) — skill · 537 installs

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 100 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
