initialize-ai-navigation — Claude Code skill
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.
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a claude-codeWhat initialize-ai-navigation 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.
What it helps with
- 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 for the agent
- 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.
How to install initialize-ai-navigation
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a claude-code2Manually: put the files in place
~/.claude/skills/initialize-ai-navigation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/initialize-ai-navigation/
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a codex2Manually: put the files in place
.agents/skills/initialize-ai-navigation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a cursor2Manually: put the files in place
.cursor/skills/initialize-ai-navigation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Unity-Technologies/skills initialize-ai-navigation2Manually: put the files in place
.github/skills/initialize-ai-navigation/SKILL.md1Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a gemini-cli2Platform CLI
gemini skills install https://github.com/Unity-Technologies/skills --path skills/initialize-ai-navigationManually: put the files in place
.devin/skills/initialize-ai-navigation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Unity-Technologies/skills --skill initialize-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 initialize-ai-navigation
How do I install initialize-ai-navigation in Claude Code?
Run npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a claude-code, then run npx skills add Unity-Technologies/skills --skill initialize-ai-navigation -a claude-code again. The skill file is at ~/.claude/skills/initialize-ai-navigation/SKILL.md.
What does initialize-ai-navigation do?
It guides setup for Unity AI Navigation components including NavMesh surfaces, agents, obstacles, links, and area settings. It also checks baked navigation and agent routes.
What should I know before sending C# to eval?
eval compiles a statement block, so it cannot use using directives. Unity types in that code must be fully qualified.
