unity-gameobject
Create and manipulate GameObjects
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-gameobjectIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides an interface for interacting with the Unity GameObject system via a local API. It is functionally safe and serves its documented purpose. A potential vulnerability surface for indirect prompt injection exists because the skill reads and processes metadata such as names and tags from the Unity scene, which could be controlled by a malicious scene file.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Unity GameObject Skills
Create, find, parent and transform scene objects. Parameters come from the schema (recommend includeSchema=true or /skills/schema?names=), which notes the non-obvious ones — never from a skill's name. Execution, dryRun and verification rules: root SKILL.md.
When to use
- Building or restructuring scene hierarchy
- Spawning or removing objects
- Adjusting transforms
Rules
- Identifiers:
entityId(string, any Unity; the only id on 6000.4+, whereinstanceIdreads0),instanceId(int, older Unity),path("Parent/Child", case-insensitive, optional scene-name prefix),name. Give at least one; precedenceentityId > instanceId > path > name. An id that names nothing isTARGET_NOT_FOUND(it may be stale), never a fallback; a missed path falls back toname. - Name matching: an exact name wins (the top-most in the Hierarchy when several share it, inactive too; Prefab Mode only by id); otherwise a single whole-word or substring match is used. Several fuzzy matches return
TARGET_NOT_FOUNDwithcandidates(path+entityIdeach) instead of guessing. Non-exact resolutions are listed in top-levelresolutionNotes. - Spaces:
gameobject_createx/y/zandrotX/Y/Zare local to the parent unlessspace:"world"(applied after parenting).gameobject_set_transformposX/Y/ZandrotX/Y/Zare world,localPosX/Y/Zlocal; it applies world position, then local position, then rotation, then scale, so local wins on a shared axis and omitted axes keep their value.scaleX/Y/Zis alwayslocalScale. RectTransform fields (anchor*,pivot*,sizeDelta*,width/height) are UI-only. - Read-back: create, set_transform and their batches return the Transform read back —
position(world),localPosition,rotation(world euler, 0–360),scale(local), asgameobject_get_inforeports them; no follow-up read needed. - Batches (
items= JSON array): all-or-nothing. One failed item reverts the whole call (rolledBack:true, the other itemsreverted:true, errorSEMANTIC_INVALID); fix the failed items and resend all. Unknown item keys are ignored and named inwarnings. Items take the single skill's identifiers and fields;gameobject_create_batchitems may parent to an item created earlier in the same call.
Skills Overview
Use *_batch for 2+ objects (one call instead of N).
| Single | Batch |
|---|---|
gameobject_create | gameobject_create_batch |
gameobject_delete | gameobject_delete_batch |
gameobject_duplicate (sibling <name>_Copy) | gameobject_duplicate_batch |
gameobject_rename | gameobject_rename_batch |
gameobject_set_transform | gameobject_set_transform_batch |
gameobject_set_active | gameobject_set_active_batch |
gameobject_set_parent (no parent id = unparent) | gameobject_set_parent_batch |
| - | gameobject_set_layer_batch |
| - | gameobject_set_tag_batch |
gameobject_set_sibling_index (index clamped) | - |
Query (no batch): gameobject_find (name substring or regex, tag, layer, component; at most limit (50) objects, truncated:true + totalMatched report a cut), gameobject_get_info (transform, parent, children, components).
Per-skill tables, item fields and return shapes: reference/<skill_name>.md — rarely needed, the schema notes the parameters.
DO NOT (common hallucinations):
gameobject_move/gameobject_rotate/gameobject_set_scale/gameobject_set_positiondo not exist → usegameobject_set_transformgameobject_add_componentdoes not exist → usecomponent_addgameobject_get_transformdoes not exist → usegameobject_get_info
Elsewhere: components → component_* skills; material or colour → material_* skills; scene_find_objects (SemiAuto) also searches objects.
Common Errors
| Error | Fix |
|---|---|
TARGET_NOT_FOUND (object, parent, child, layer) | Retry with a candidates entry's path / entityId, or locate it via gameobject_find / scene_get_hierarchy. |
MISSING_PARAM | Supply it (e.g. newName, items); the error (or a dryRun) lists all parameters. |
SEMANTIC_INVALID | Use an allowed value from the message (primitiveType, space local/world, a registered tag) or fix the failed results items. |
Transport codes (COMPILING, RATE_LIMIT, ...) → error codes.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-gameobject">View unity-gameobject on skillZs</a>