unity-smart

Query Unity scene objects with SQL-like property filters and automate layouts.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/Yuan-Zzzz/FrogRE --skill unity-smart-yuan-zzzz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/Yuan-Zzzz/FrogRE/tree/main/.codex/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/Yuan-Zzzz/FrogRE --skill unity-smart-yuan-zzzz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity scene maintenance and level setup often require tedious manual searching for objects by properties, arranging many objects spatially, and wiring serialized references across GameObjects. This Skill reduces repetitive editor work by providing SQL-like scene queries, automated spatial layouts, spatial region searches, ground alignment, and bulk reference binding so designers and engineers can focus on design rather than manual editing.

Core Features & Use Cases

  • SQL-like Scene Queries: Find GameObjects by component and property conditions (equals, contains, comparisons) to quickly locate misconfigured or high-impact objects, for example lights with intensity > 2.
  • Automated Layouts & Distribution: Arrange selected objects in Linear, Grid, Circle, or Arc layouts, distribute evenly between endpoints, and snap to configurable grids for consistent level construction.
  • Reference Auto-Binding: Auto-fill List/Array fields on target components by matching objects by tag or name, simplifying tasks like populating spawn point arrays or collectible lists.
  • Spatial & Alignment Tools: Search within sphere/box regions, raycast-align objects to ground, randomize transforms, and replace selections with prefabs while preserving transforms.
  • Use Case: Quickly locate all enemy spawn points within a radius, arrange them in a formation, and auto-populate the GameManager's spawn list for runtime spawning.

Quick Start

Find all Light components with intensity greater than 2, arrange the results in a circle with radius 5, and auto-bind matching SpawnPoint objects to the GameManager.spawns field.

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 GameObjects by component properties like light intensity?

You can query Unity GameObjects using SQL-like property conditions to find components matching specific criteria, such as locating all lights with an intensity greater than two. This allows precise filtering by component properties, string contains matches, and numerical comparisons to quickly identify misconfigured objects.

Can I automatically arrange Unity scene objects in grid or circle layouts?

Yes, you can automatically arrange Unity scene objects in linear, grid, circle, or arc layouts. The layout tools distribute selected objects evenly between endpoints and snap them to configurable grids, ensuring consistent spatial distribution for level construction without manual placement.

What is the best way to auto-bind spawn point lists to a GameManager in Unity?

Auto-binding spawn point lists to a GameManager is done by matching GameObjects by tag or name to populate List or Array fields. This auto-fill mechanism targets serialized reference fields on components, simplifying tasks like populating spawn point arrays or collectible lists without manual dragging.

How do I find all GameObjects within a specific spatial region in a Unity scene?

To find GameObjects within a spatial region, you perform spatial region searches using sphere or box volumes in the Unity scene. This locates objects based on their physical presence within defined areas, which is useful for grouping entities by proximity before applying layouts or reference bindings.

Does Unity scene layout and query work with raycast ground alignment for prefabs?

Unity scene layout and query supports raycast-based ground alignment to snap objects to terrain surfaces. Additionally, you can replace selections with prefabs while preserving their original transforms, ensuring replaced objects maintain their spatial position and rotation during scene maintenance.

Why do I need SQL-like scene queries for Unity level design instead of manual selection?

SQL-like scene queries are needed for Unity level design to eliminate tedious manual searching for objects by properties. They quickly locate high-impact or misconfigured objects across complex scenes, allowing designers to filter by component conditions and spatial regions, reducing repetitive editor work and focusing on design.