# initialize-ai-navigation

Sets up Unity AI Navigation components for NavMesh pathfinding, patrols, links, and obstacle avoidance. Use it when a scene needs navigable agents or route troubleshooting.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 5400 installs · ★ 1149
- Author: Unity-Technologies
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Unity-Technologies/skills/tree/HEAD/skills/initialize-ai-navigation/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/initialize-ai-navigation

## What it does

This skill guides Unity AI Navigation setup, from checking `com.unity.ai.navigation` to creating NavMeshSurface, NavMeshAgent, NavMeshObstacle, and NavMeshLink components. It first looks for navigation components in scenes and prefabs, checks agent types, and gathers requirements for walkable areas, routes, obstacles, and area costs.

The workflow covers baking a NavMesh, adding agents, dynamic obstacles, links across disconnected areas, and scripts for patrols, click-to-move, or animation. Validation checks agent paths, matching agent types, area masks, and Rigidbody settings. C# sent to `eval` needs fully qualified types; `using` directives cause compilation errors there.

Do not guess the package version: a version that does not exist can make Unity package resolution fail silently. That is a reason to verify it against the Unity registry or a nearby package in `Packages/manifest.json`.

## Requirements
- Works with: Unity

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Unity-Technologies/skills initialize-ai-navigation
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Unity-Technologies/skills --path skills/initialize-ai-navigation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill initialize-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/Unity-Technologies/skills/tree/HEAD/skills/initialize-ai-navigation/SKILL.md

## When to use it
- bake a NavMesh for walkable surfaces
- add pathfinding to a character
- build a patrol route between points
- connect separated areas with NavMeshLink
- configure avoidance around dynamic obstacles

## Example prompts
- Set up Unity AI Navigation for this character and bake the NavMesh.
- Create a patrol between waypoints for my NavMesh agent.
- Why cannot my NavMeshAgent find a path? Inspect the current scene.

## Similar
- [unity-navmesh](https://affpapa.org/en/nevibecode/skills/unity-navmesh.md) — skill · 5500 installs
- [unity-csharp-scripting](https://affpapa.org/en/nevibecode/skills/unity-csharp-scripting.md) — skill · 5900 installs
- [unity-developer](https://affpapa.org/en/nevibecode/skills/unity-developer.md) — skill · 3000 installs
- [unity-vrc-udon-sharp](https://affpapa.org/en/nevibecode/skills/unity-vrc-udon-sharp.md) — skill · 1000 installs
- [unity](https://affpapa.org/en/nevibecode/skills/unity.md) — skill · 908 installs
- [c-sharp](https://affpapa.org/en/nevibecode/skills/c-sharp.md) — skill · 760 installs

From the same set: [unity-technologies/skills](https://affpapa.org/en/nevibecode/by/unity-technologies/skills.md) — 28 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