unity-physics

Installation
SKILL.md

Unity Physics Skills

Editor-time physics queries (raycast, sphere and box casts, overlap), gravity, PhysicMaterial assets and the layer collision matrix. Parameters come from the schema (GET /skills/schema?names=<skill>&wire=v2); execution and dryRun rules: root SKILL.md.

When to use

  • Casting rays or shapes
  • Testing overlaps
  • Querying colliders
  • Adjusting gravity or physics settings

Rules

  • Each query is a single-frame check on the editor thread. Simulation (integration, collision response) advances only in Play Mode; these skills never start a simulation.
  • Raycast and cast results use world-space coordinates.
  • layerMask on queries is a bit mask (bit n = layer n; for example 256 = layer 8 only), not a layer index. -1 means all layers.
  • layer1 and layer2 on the layer-collision skills are indices 0-31. A name from layer1Name / layer2Name overrides the index on the same side.
  • Adding physics components belongs to the component module (component_add with Rigidbody, BoxCollider, etc.).
Installs
83
GitHub Stars
1.9K
First Seen
Mar 14, 2026