unity-smart

Query, arrange, and bind Unity scene objects using SQL-like filters and spatial regions.

2|Updated May 18, 2026
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-smart-pcone-mm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-smart-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually locating, arranging, and wiring objects in large Unity scenes is slow and error-prone. This Skill automates scene queries, layout arrangement, and reference binding so repetitive scene operations complete in a single command. ## Core Features & Use Cases - SQL-like Scene Queries: Find objects by component property conditions (e.g., all Lights with intensity > 2) or by spatial region (sphere/box around a coordinate). - Automatic Layout & Alignment: Arrange selected objects in Linear, Grid, Circle, or Arc patterns, distribute them evenly, snap to grid, align to ground, or randomize transforms. - Auto Reference Binding: Fill a component's List/Array field with objects matched by tag or name, replacing manual drag-and-drop wiring. - Use Case: A level designer selects 20 props and asks to arrange them in a circle with radius 5, then binds all SpawnPoint-tagged objects into the GameController's spawns field automatically. ## Quick Start Find all lights in the scene with intensity greater than 2 and arrange the selected objects in a circle layout.

Frequently Asked Questions about unity-smart

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

FAQPage Schema
How do I find Unity objects by component property value?

Use smart_scene_query with a component name, property name, comparison operator, and value, such as finding all Light components with intensity greater than 2. It supports ==, !=, >, <, >=, <=, and contains operators with a configurable result limit.

How to arrange Unity objects in a circle or grid automatically?

Select the objects in the Hierarchy, then call smart_scene_layout with a layoutType of Circle, Grid, Linear, or Arc. You can control spacing, grid columns, arc angle, and whether objects rotate to face the center.

Can I auto-fill a Unity component list field with tagged objects?

Yes, smart_reference_bind fills a List or Array field on a target component with objects matched by tag or name substring. Set appendMode to true to add to existing entries instead of replacing them.

Does smart_scene_query support natural language query strings?

No, the query parameter is an unsupported shorthand and returns a guidance error if used alone. You must specify componentName and propertyName explicitly with an operator and value.

Why does smart_replace_objects return MODE_FORBIDDEN?

smart_replace_objects is flagged as a high-risk skill because it deletes original objects during replacement. It is blocked in Approval and Auto modes and only runs under Bypass mode or when explicitly allowlisted.

What are the limitations of spatial scene queries in Unity?

smart_scene_query_spatial searches within a sphere defined by center coordinates and radius, defaulting to 10 units and 50 results. It cannot create or move objects; use snap_to_grid or align_to_ground for positioning instead.