unity-smart

Query and manipulate Unity scene GameObjects by component properties and spatial regions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the repetitive manual work of finding the right objects in a Unity scene and then arranging, aligning, distributing, snapping, randomizing, and wiring their references.

Core Features & Use Cases

  • SQL-like scene querying: Locate objects by component properties (for example, all Lights where intensity is above a threshold) and also filter by spatial regions.
  • Automatic scene layout & transforms: Arrange selected objects into grid, circle, arc, or line patterns, align them to ground, distribute evenly, snap to a grid, and randomize transforms.
  • Reference binding & prefab replacement: Auto-fill serialized array/list fields by matching scene objects and replace selected objects with a prefab while preserving transforms.

Quick Start

Use the unity-smart skill to query all objects with a Light component whose intensity is greater than 2, then arrange the results into a circle.

Frequently Asked Questions about unity-smart

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

FAQPage Schema
How do I find and select Unity scene objects based on component properties?

You can query Unity scene objects by component property rules using SQL-like scene querying to filter GameObjects by conditions like Light intensity thresholds. This eliminates manual selection by running targeted property filters across the scene.

Can I automatically arrange and align multiple GameObjects in a Unity scene?

Yes, you can automatically arrange selected GameObjects into grid, circle, arc, or line patterns, align them to ground, distribute evenly, and snap to grid. This automates scene layout and transform workflows without manual placement.

What is the best way to replace Unity prefabs while preserving their transforms?

Use prefab replacement workflows to swap selected objects with a target prefab while preserving their existing transforms. This approach operates under approval-mode restrictions to safeguard against unintended high-risk scene modifications.

How do I auto-fill serialized array or list references in Unity?

Automated serialized reference binding auto-fills array and list fields by matching scene objects based on query results. This eliminates manual wiring of references across multiple GameObjects in your Unity scene.

Does spatial search work for filtering Unity scene objects by region constraints?

Yes, spatial search filters Unity scene objects by spatial region constraints. You execute spatial region filters alongside property filters to isolate GameObjects within specific physical boundaries of your scene.

Are there limitations when doing mass prefab replacement in Unity scenes?

Prefab replacement is a high-risk operation restricted to approval-mode, meaning you must explicitly approve changes before execution. This precaution prevents accidental mass object deletion or unintended scene modifications.