godot-ai-navigation — Claude Code skill: AI routing decisions for Godot
godot-ai-navigation is a skill that helps choose Godot navigation architecture for agents, including enemies and crowds.
LGPL-3.0 242 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a claude-codeWhat godot-ai-navigation 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.
What it helps with
- 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 for the agent
- 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
How to install godot-ai-navigation
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a claude-code2Manually: put the files in place
~/.claude/skills/godot-ai-navigation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-ai-navigation/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a codex2Manually: put the files in place
.agents/skills/godot-ai-navigation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a cursor2Manually: put the files in place
.cursor/skills/godot-ai-navigation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-ai-navigation2Manually: put the files in place
.github/skills/godot-ai-navigation/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-ai-navigationManually: put the files in place
.devin/skills/godot-ai-navigation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-ai-navigation
How do I install godot-ai-navigation in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-ai-navigation -a claude-code, then open ~/.claude/skills/godot-ai-navigation/SKILL.md to access the decision trees.
What does godot-ai-navigation do?
Provides four decision trees to choose your navigation architecture: node agent vs RID server, static vs dynamic baking, layers and links, retarget policy. Each choice leads to a ready-made script.
When should I use NavigationAgent instead of RID server?
NavigationAgent works for up to ~50 agents in top-down or slope navigation with editor tuning. RID server scales to hundreds or thousands of simple movers but has higher per-frame calculation cost for small counts.