skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
besty0728/unity-skills86 installs

unity-navmesh

Bake and query Unity NavMesh

How do I install this agent skill?

npx skills add https://github.com/besty0728/unity-skills --skill unity-navmesh
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides tools for managing Unity NavMesh navigation. No security issues were detected.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

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.

Skills

navmesh_bake

Bake the NavMesh (synchronous). Blocks the Editor; can be slow on large scenes. Parameters: None.

navmesh_clear

Clear the NavMesh data. Parameters: None.

navmesh_calculate_path

Calculate a path between two points. Parameters:

  • startX, startY, startZ (float): Start position.
  • endX, endY, endZ (float): End position.
  • areaMask (int, optional): NavMesh area mask.

Returns: { status, valid, distance, cornerCount, corners }

  • status: PathComplete, PathPartial, PathInvalid, or NoPath.
  • valid: true only when status == "PathComplete".
  • distance: total length of the corners (0 for invalid paths).
  • cornerCount: number of entries in corners.
  • corners: array of {x, y, z} waypoints (empty when there is no path).

navmesh_add_agent

Add a NavMeshAgent component to an object.

ParameterTypeRequiredDefaultDescription
namestringNonullGameObject name
entityIdstringNonullGameObject entity ID (preferred; the only id on Unity 6000.4+)
instanceIdintNo0GameObject instance ID
pathstringNonullGameObject hierarchy path

Returns: { success, gameObject }

navmesh_set_agent

Set NavMeshAgent properties (speed, acceleration, radius, height, stoppingDistance).

ParameterTypeRequiredDefaultDescription
namestringNonullGameObject name
entityIdstringNonullGameObject entity ID (preferred; the only id on Unity 6000.4+)
instanceIdintNo0GameObject instance ID
pathstringNonullGameObject hierarchy path
speedfloatNonullAgent movement speed
accelerationfloatNonullAgent acceleration
angularSpeedfloatNonullAgent angular speed
radiusfloatNonullAgent radius
heightfloatNonullAgent height
stoppingDistancefloatNonullDistance to stop before target

Returns: { success, gameObject, speed, radius }

navmesh_add_obstacle

Add a NavMeshObstacle component to an object.

ParameterTypeRequiredDefaultDescription
namestringNonullGameObject name
entityIdstringNonullGameObject entity ID (preferred; the only id on Unity 6000.4+)
instanceIdintNo0GameObject instance ID
pathstringNonullGameObject hierarchy path
carveboolNotrueEnable carving

Returns: { success, gameObject, carving }

navmesh_set_obstacle

Set NavMeshObstacle properties (shape, size, carving).

ParameterTypeRequiredDefaultDescription
namestringNonullGameObject name
entityIdstringNonullGameObject entity ID (preferred; the only id on Unity 6000.4+)
instanceIdintNo0GameObject instance ID
pathstringNonullGameObject hierarchy path
shapestringNonullObstacle shape (e.g. Box, Capsule); an unknown value is rejected before any write
sizeXfloatNonullObstacle size X
sizeYfloatNonullObstacle size Y
sizeZfloatNonullObstacle size Z
carvingboolNonullEnable carving

Returns: { success, gameObject, shape, carving }

navmesh_sample_position

Find the nearest point on the NavMesh.

ParameterTypeRequiredDefaultDescription
xfloatYes-Source position X
yfloatYes-Source position Y
zfloatYes-Source position Z
maxDistancefloatNo10Maximum search distance

Returns: { success, found, point: { x, y, z }, distance }

navmesh_set_area_cost

Set an area's traversal cost.

ParameterTypeRequiredDefaultDescription
areaIndexintYes-NavMesh area index, 0-31
costfloatYes-Traversal cost, >= 0

Returns: { success, areaIndex, cost }

navmesh_get_settings

Get NavMesh build settings.

Parameters: None.

Returns: { success, agentRadius, agentHeight, agentSlope, agentClimb }

Routing

  • NavMeshAgent or NavMeshObstacle properties beyond these skills → component_add / component_set_property.
  • Path queries stay in this module (navmesh_calculate_path).

DO NOT (common hallucinations):

  • navmesh_create does not exist: use navmesh_bake.
  • navmesh_add_agent_component and navmesh_set_agent_speed do not exist: use navmesh_add_agent then navmesh_set_agent.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-navmesh">View unity-navmesh on skillZs</a>