initialize-ai-navigation
An agent skill by Unity-Technologies, from Unity-Technologies/unity-agent-plugin. Tags: ai, debugging, navigation, pathfinding, setup.
What it does
Sets up and configures the Unity AI Navigation system — NavMesh surfaces, NavMesh agents, obstacles, links, modifiers, areas and costs. Use when creating walkable navigation meshes, adding pathfinding agents, setting up patrol routes, configuring obstacle avoidance and carving, connecting separate NavMeshes with links, coupling navigation with animation, or troubleshooting navigation issues.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add Unity-Technologies/unity-agent-plugin --skill initialize-ai-navigation
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/Unity-Technologies/unity-agent-plugin
cp -r unity-agent-plugin/skills/initialize-ai-navigation ~/.claude/skills/initialize-ai-navigation
Safety box score
Grade B, low risk: 21 of 100 risk points, rated 2026-10-11. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This is a documentation-only Unity navigation skill that can edit the project manifest and drive a connected Unity Editor to add, bake, and configure NavMesh components. The main risks are remote package downloads from Unity's registry and editor-side C# execution via `eval`; there are no embedded binaries or secret-handling flows.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 1 (low) | It directs the agent to pass C# to `eval` and shows `UnityEditor.PackageManager.Client.Add(...)`, but it ships no native or standalone executable scripts. |
| Network access | 2 (moderate) | It explicitly sends the user to `https://packages.unity.com/com.unity.ai.navigation` and uses `Client.Add("com.unity.ai.navigation@2")`, which reaches out to Unity to fetch package data/code. |
| Filesystem reach | 2 (moderate) | It tells the agent to edit `Packages/manifest.json` and inspect scene/prefab files for `NavMeshSurface`, `NavMeshAgent`, and related components. |
| Secrets & credentials | 0 (none) | No tokens, passwords, `.env` files, keychains, browser sessions, or other credential stores are referenced. |
| Privilege & persistence | 0 (none) | There is no sudo, service registration, global install, or OS/shell settings change requirement. |
| Instruction hijack surface | 0 (none) | The docs do not instruct the agent to ignore its rules, hide content, or follow external prompt text; the imperatives are scoped to navigation setup. |
| Irreversible actions | 1 (low) | It can create and bake NavMesh assets in the Unity project, but it asks for missing details first and does not publish, pay, delete, or deploy externally. |
| Transparency | 0 (none) | Everything is plain markdown text; there are no binaries, base64 blobs, or unreadable installers. |
Before installing
- Read `SKILL.md` and `references/navigation-system.md` for every command that touches `Packages/manifest.json` or the live Editor.
- Confirm you are okay with the skill contacting `packages.unity.com` and downloading `com.unity.ai.navigation`.
- Back up `Packages/manifest.json` and the target scene/prefab files before letting it run.
- Test it in a scratch Unity project or branch first, especially if the Editor will be connected for `eval` commands.
Rated 2026-10-11 by an automated review of 2 files from the skill's repository.
Source
- Repository
- Unity-Technologies/unity-agent-plugin (all skills from this repository)
- Path
- skills/initialize-ai-navigation/SKILL.md
- Branch
- main
- Updated
- 2026-09-22
Related skills
- openclaw-model-switch — Switch or repair the model configuration of an OpenClaw instance (e.g. Kimi k2p6 → k3): change the default model, add model definitions.
- agents-debug — Use when your agent or environment is broken — wrong answers, errors, timeouts, tool failures, or CLI issues. Reads traces and logs to diagnose root causes.
- setup-pstack — Configure which models pstack uses per role and at what reasoning budget.
- agents-sdk — Build, debug, or review Cloudflare Agents SDK applications using the agents package.
- auto-repo-setup — Diagnose, repair, and standardize repository setup and safe Git workflows for Claude Code or Codex.
- claude-code-hooks — How to write, test, register, and debug Claude Code hooks — PreToolUse / PostToolUse / SessionStart / Stop Bash guards that enforce a rule the model would.