unity-smart

Query, arrange, and auto-bind Unity scene objects using component and spatial filters.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-smart-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-smart-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually locating, arranging, and wiring references between objects in large Unity scenes is slow and error-prone. This Skill automates scene queries, layout arrangement, and reference binding so repetitive scene-editing work is done programmatically. ## Core Features & Use Cases - SQL-like Scene Queries: Find objects by component property values (e.g., all Lights with intensity > 2) or by spatial region using sphere/box filters. - Layout & Transform Tools: Arrange selected objects in Linear, Grid, Circle, or Arc layouts, distribute them evenly, snap to grid, align to ground, or randomize transforms. - Auto Reference Binding: Automatically fill List/Array fields on components with objects matched by tag or name. - Use Case: A level designer selects dozens of props and uses smart_scene_layout to arrange them in a circle, then uses smart_reference_bind to fill a GameController's spawn point list with all objects tagged SpawnPoint. ## Quick Start Ask the AI to find all Light components in the Unity scene with intensity greater than 2 and arrange the selected objects in a grid 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 componentName, propertyName, an operator like > or ==, and a comparison value. For example, querying Light components with intensity greater than 2 returns all matching objects, up to the configurable result limit.

How to auto-arrange selected objects in a Unity scene?

Use smart_scene_layout with a layoutType of Linear, Grid, Circle, or Arc after selecting objects in the Hierarchy. Parameters like spacing, columns, and arcAngle control the arrangement, and lookAtCenter rotates objects to face the center.

Can I search Unity scene objects within a specific area?

Yes, smart_scene_query_spatial finds objects inside a sphere defined by center coordinates and radius. You can optionally filter results by component type and cap the number of returned objects with the limit parameter.

Why does smart_replace_objects return MODE_FORBIDDEN?

smart_replace_objects is flagged as a high-risk skill because it deletes original objects when replacing them with a prefab. It only runs in Bypass mode or when explicitly allowlisted; Approval and Auto modes reject it with MODE_FORBIDDEN.

Does this skill create new GameObjects in Unity?

No, the smart module only queries, arranges, and binds existing objects. Skills like smart_create or smart_build do not exist; use the gameobject module for creating objects and gameobject_find for simple searches.