Scene Bootstrap
Create scenes, add starter GameObjects, and attach initial components via unity-cli. This skill owns greenfield scene authoring; it hands off to unity-gameobject-edit or unity-prefab-workflow once objects already exist.
Use When
- The user wants to create a brand-new scene from scratch.
- The user asks to add initial GameObjects and components while bootstrapping a scene.
- The user needs help loading, saving, or organising a fresh scene authoring workflow.
Do Not Use When
- The request mainly mutates existing objects in an already-prepared scene; use
unity-gameobject-edit. - The work happens inside prefab edit mode; use
unity-prefab-workflow. - The user only wants to read or analyse a scene; use
unity-scene-inspect.
Preferred Flow
- Create or load a scene with
scene createorraw load_scene. - Create GameObjects (optionally with a primitive type and
parentPath). - Attach components via
add_component. - Persist with
save_sceneafter the bulk authoring is complete.
unity-cli scene create MainMenu --path Assets/Scenes/
unity-cli raw create_gameobject --json '{"name":"Player","primitiveType":"Cube"}'
unity-cli raw add_component --json '{"gameObjectPath":"/Player","componentType":"Rigidbody"}'
unity-cli raw save_scene --json '{"scenePath":"Assets/Scenes/MainMenu.unity"}'
Examples
- "Create a new gameplay scene and add a
Playerobject with physics components." - "Load
Assets/Scenes/TestScene.unity, add a camera rig, then save it." - "Bootstrap a simple empty scene for UI testing."
References
- runtime-checklist.md: connection and instance selection prerequisites.
- scene-bootstrap-patterns.md: safe scene setup order and starter patterns.