unity-navmesh

Bake and query Unity NavMesh paths, agents, obstacles, and bake settings.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-navmesh-du-qwq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-navmesh
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills/skills/navmesh
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-navmesh-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up and validating navigation in Unity requires repetitive editor work: baking NavMeshes, adding NavMeshAgent and NavMeshObstacle components, and testing whether paths between points are valid. This Skill exposes those operations as callable commands so navigation setup and path testing can be done conversationally. ## Core Features & Use Cases - NavMesh Baking & Clearing: Bake or clear navigation mesh data, with warnings that baking is synchronous and can block on large scenes. - Path Querying: Calculate paths between two points with area masks, returning status, distance, and corner waypoints; sample the nearest valid NavMesh position. - Agent & Obstacle Configuration: Add and configure NavMeshAgent (speed, radius, stopping distance) and NavMeshObstacle (shape, carving) components, plus set area traversal costs. - Use Case: After placing level geometry, ask to bake the NavMesh, then verify an enemy can reach the player by calculating a path between their positions and checking that the status is PathComplete. ## Quick Start Bake the NavMesh in the current Unity scene, then calculate a path from (0, 0, 0) to (10, 0, 10) and tell me whether it is complete.

Frequently Asked Questions about unity-navmesh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bake a NavMesh in Unity from a script or command?

Use the navmesh_bake operation, which synchronously bakes the NavMesh for the current scene. Be aware it blocks the main thread, so large scenes may take noticeable time to complete.

How to check if a path exists between two points on a Unity NavMesh?

Use navmesh_calculate_path with start and end coordinates and an optional area mask. It returns a status of PathComplete, PathPartial, or PathInvalid, plus total distance and corner waypoints.

Does NavMesh need to be re-baked after changing scene geometry?

Yes, the NavMesh must be re-baked after scene geometry changes for agents to navigate the updated layout. Static baked data does not update automatically when objects move or are added.

Why is navmesh_clear not executing in semi-auto mode?

navmesh_clear is marked as a Delete operation and is statically blocked in SemiAuto mode. It only runs in Bypass mode or when explicitly added to the allowlist.

How do I find the nearest valid point on a NavMesh?

Use navmesh_sample_position with a source position and optional maximum search distance, which defaults to 10. It returns whether a point was found along with its coordinates and distance.