| name | unity-prefab-workflow |
| description | Manage Unity prefab assets with unity-cli. Use when the user asks to create a prefab from a scene object, open a prefab in edit mode, save prefab changes, instantiate a prefab, or update prefab asset properties. Do not use for general scene object editing; use `unity-gameobject-edit` or `unity-scene-create` instead. |
| allowed-tools | Bash(unity-cli:*), Read, Grep, Glob |
| metadata | {"author":"akiojin","version":"0.3.0","category":"prefabs","triggers":["prefab","instantiate","edit-mode","asset"],"siblings":["unity-gameobject-edit","unity-scene-create","unity-asset-management"]} |
Prefab Workflow
Create, open, edit, and instantiate prefab assets via unity-cli. This skill owns the prefab edit-mode lifecycle; scene-instance edits belong to unity-gameobject-edit.
Use When
- The user wants to create or update a prefab asset.
- The task requires entering prefab edit mode and saving changes back to the asset.
- The user wants to instantiate prefab assets into a scene with specific transforms.
Do Not Use When
- The request edits ordinary scene objects with no prefab asset involved; use
unity-gameobject-edit.
- The task is bootstrapping a fresh scene; use
unity-scene-create.
- The request is about asset import settings or materials; use
unity-asset-management.
Preferred Flow
open_prefab to enter edit mode (or create_prefab from a scene object).- Apply edits via
add_component, modify_component, or set_component_field.
save_prefab to persist changes back to the asset.exit_prefab_mode to return to scene authoring.
unity-cli raw create_prefab --json '{"gameObjectPath":"/Player","prefabPath":"Assets/Prefabs/Player.prefab"}'
unity-cli raw open_prefab --json '{"prefabPath":"Assets/Prefabs/Player.prefab"}'
unity-cli raw save_prefab --json '{}'
unity-cli raw exit_prefab_mode --json '{}'
unity-cli raw instantiate_prefab --json '{"prefabPath":"Assets/Prefabs/Player.prefab","position":{"x":0,"y":0,"z":0}}'
Examples
- "Create a prefab from
/Player and save it under Assets/Prefabs/Player.prefab."
- "Open an existing prefab, change a field, save it, and exit prefab mode."
- "Instantiate a prefab at the origin for a test scene."
References
