unity-physics

Configure Unity physics settings and validate raycast, overlap, and cast queries.

6|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/dyCuong03/unity-agent-team --skill unity-physics-dycuong03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-physics
Source: https://github.com/dyCuong03/unity-agent-team/tree/main/.claude/skills/unity-skills/skills/physics
Command: npx skills add https://github.com/dyCuong03/unity-agent-team --skill unity-physics-dycuong03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you query and configure Unity editor-time physics settings without manually running scenes or repeatedly checking collision behavior.

Core Features & Use Cases

  • Raycast & Cast Queries: Perform raycasts, spherecasts, and boxcasts to retrieve hit information for editor-time diagnostics and placement logic.
  • Overlap Checks: Detect nearby colliders via sphere/box overlap queries to validate spatial rules and interactions.
  • Physics Configuration: Read and set global gravity, create PhysicMaterial assets, update collider materials, and configure the layer collision matrix.

Quick Start

Ask to cast a ray from a point in a direction with a layer mask limit and return the closest hit details.

Frequently Asked Questions about unity-physics

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

FAQPage Schema
How do I perform a Unity raycast at editor time without running the game?

Unity raycast queries can be executed at editor time to retrieve hit information for diagnostics and placement logic. You can cast rays, spherecasts, and boxcasts to validate collision behavior without manually running scenes.

Can I check sphere and box overlaps in Unity to validate spatial rules?

Yes, Unity overlap checks detect nearby colliders via sphere and box overlap queries. This allows you to validate spatial rules and interactions directly in the editor without launching a full simulation.

What is the best way to configure global gravity and PhysicMaterial assets in Unity?

Configuring Unity physics settings involves reading and setting global gravity, creating PhysicMaterial assets, and updating collider materials. This is done through safe asset and global settings writes in the editor.

How do I manage the Unity layer collision matrix for specific gameplay geometry?

The Unity layer collision matrix can be managed by configuring layer collision rules to tune gameplay geometry. This editor-time workflow allows safe writes to global settings to precompute collision behavior without running scenes.

Does Unity physics queries support deterministic single-frame checks for debugging?

Yes, Unity physics queries support deterministic single-frame checks for debugging. They execute editor-thread operations for raycasts and overlap checks, allowing you to validate outcomes without running full physics simulations.