unity-smart

Query Unity scene objects by component properties and spatial relationships.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-smart-mandexonla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/mandexonla/Top-Down-Template/tree/main/.codex/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-smart-mandexonla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables rapid discovery, organization, and wiring of Unity scene objects so designers and engineers can avoid manual searching, repetitive placement, and error-prone reference assignment during level setup.

Core Features & Use Cases

  • SQL-like Scene Queries: Find objects by component type and property conditions (==, !=, >, <, contains) to locate lights, cameras, or custom components quickly.
  • Automated Layouts: Arrange selected objects in Linear, Grid, Circle, or Arc patterns with spacing, columns, and look-at-center options to speed level composition.
  • Spatial Searches & Alignment: Perform sphere/box spatial queries, snap objects to a grid, align objects to ground using raycasts, evenly distribute between endpoints, and randomize transforms for organic placement.
  • Reference Auto-Binding & Replacement: Auto-fill List/Array serialized fields on target components by tag or name filters, and replace selected objects with prefabs while preserving transforms.
  • Use Case: Select spawn placeholders, use a spatial or property query to collect them, auto-bind the collection to GameManager.spawns, arrange them into a formation, and replace placeholders with final prefabs.

Quick Start

Call smart_scene_query to find all objects with component Light intensity > 2, then arrange the results in a circle with spacing 5 using smart_scene_layout.

Frequently Asked Questions about unity-smart

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

FAQPage Schema
How do I query Unity scene objects by component properties?

You can query Unity scene objects by component properties using SQL-like conditions to filter by type and values like ==, !=, >, <, and contains to locate specific items.

What's the best way to auto-layout and arrange Unity objects in a circle?

The best way to auto-layout Unity objects is by arranging selected items in Linear, Grid, Circle, or Arc patterns with configurable spacing, columns, and look-at-center options.

Can I auto-fill List or Array serialized fields on Unity components?

Yes, you can auto-fill List and Array serialized fields on target Unity components by matching objects through tag or name filters during level assembly.

How do I replace Unity placeholder objects with prefabs while keeping transforms?

You can replace selected Unity objects with prefabs while preserving their existing transforms, allowing seamless swapping of placeholder assets with final prefabs.

Does spatial search in Unity support sphere and box queries?

Yes, spatial search in Unity supports both sphere and box spatial filters to find objects within specific geometric boundaries in the scene.

How to snap Unity objects to grid and align them to ground using raycasts?

To snap Unity objects to a grid and align them to ground, you apply snapping commands and raycast-based alignment to evenly distribute and position selected transforms.