unity-navmesh

Installation
SKILL.md

Unity NavMesh Skills

Bake or clear NavMesh data, calculate paths, sample positions, set area costs and configure NavMeshAgent and NavMeshObstacle components. Parameters come from the schema (GET /skills/schema?category=NavMesh&wire=v2); execution and dryRun rules: root SKILL.md.

When to use

  • Setting up navigation for a scene
  • Baking or clearing a NavMesh
  • Testing agent paths or nearest reachable points
  • Tuning agent or obstacle settings and area traversal costs

Rules

  • navmesh_bake runs synchronously and blocks the Editor; on large scenes warn the user first.
  • Re-bake after scene geometry changes; the NavMesh does not follow them.
  • navmesh_clear is a Delete operation: it is refused in Approval and Auto, and runs only in Bypass or when allowlisted.
  • Query skills (navmesh_calculate_path, navmesh_sample_position, navmesh_get_settings) are read-only and run in every mode; the write skills need a grant under Approval.

Pitfalls

  • navmesh_calculate_path returns status: "NoPath" when NavMesh.CalculatePath returns false; PathPartial is not valid.
  • navmesh_set_area_cost takes areaIndex 0-31 and cost >= 0.
Installs
86
GitHub Stars
1.9K
First Seen
Mar 14, 2026