unity-smart

Query Unity scene objects by component properties and automate spatial layouts.

8|1|Updated Oct 7, 2025
One-click install
npx skills add https://github.com/Zzulin/unity-project01 --skill unity-smart-zzulin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/Zzulin/unity-project01/tree/main/URP1/Plugins/Unity-Skills-main/SkillsForUnity/unity-skills~/skills/smart
Command: npx skills add https://github.com/Zzulin/unity-project01 --skill unity-smart-zzulin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Large Unity scenes are hard to inspect and manipulate manually; designers and developers need a fast, reliable way to find objects by component properties, arrange many objects spatially, and auto-fill serialized references without manual dragging and searching.

Core Features & Use Cases

  • SQL-like scene queries: Use smart_scene_query to filter scene objects by component and property conditions (==, !=, >, <, contains) for tasks like locating lights, cameras, or renderers that match criteria.
  • Automatic spatial layouts: Use smart_scene_layout to arrange selections in Linear, Grid, Circle, or Arc formations with configurable spacing, columns, and arc angles for level design or presentation.
  • Reference auto-binding: Use smart_reference_bind to populate List/Array serialized fields on a target component using tag/name filters or append mode, ideal for wiring spawns or manager references.
  • Selection and transform utilities: Includes spatial queries (smart_scene_query_spatial), ground alignment, grid snapping, distribution, randomization, replacement with prefabs, and selecting by component for bulk edits.

Quick Start

Call smart_scene_query to find all Light components with intensity greater than 2 and then run smart_scene_layout with layoutType Circle and spacing 5 to arrange the results.

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 filters to locate specific items like lights or cameras based on conditions like equality or containment.

What is the best way to arrange multiple GameObjects in a grid or circle?

The best way to arrange GameObjects is by using automatic spatial layout tools that position selections in Grid, Circle, Linear, or Arc formations with configurable spacing and columns.

How do I auto-fill serialized reference lists in Unity without manual dragging?

You can auto-fill serialized reference lists by using reference auto-binding tools that populate List or Array fields on target components using tag or name filters, eliminating manual dragging.

Can I filter Unity scene objects using spatial region queries?

Yes, you can filter Unity scene objects using spatial region queries to narrow down selections by physical area, which can then be combined with grid snapping and ground alignment for bulk edits.

What are the limitations of SQL-like scene queries in Unity editor workflows?

SQL-like scene queries in Unity editor workflows are limited to operating within the editor environment and rely on clear success or limit responses, meaning they do not process runtime scene objects or unsupported component properties.