scene-hierarchy-design

Organize Summer Engine scene hierarchies by access pattern using wrapper nodes and sub-scenes.

66|4|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/SummerEngine/summer --skill scene-hierarchy-design-summerengine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scene-hierarchy-design
Source: https://github.com/SummerEngine/summer/tree/main/library/skills/scene-hierarchy-design
Command: npx skills add https://github.com/SummerEngine/summer --skill scene-hierarchy-design-summerengine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game scenes in Summer Engine (Godot-based) often grow ad hoc, producing deep fragile node paths, duplicated inline clusters, and scripts that break whenever the hierarchy is reorganized. This Skill provides a structured method for designing scene hierarchies around the operations the game actually performs. ## Core Features & Use Cases - Access-pattern-driven structure: Group nodes operated on together under wrapper parents, keep type-queried nodes as flat siblings, and keep unique nodes inline. - Asset vs live hierarchy separation: Extract repeated clusters into reusable .tscn sub-scenes and instantiate them instead of duplicating inline setups. - Path-agnostic logic: Replace hardcoded deep node paths with groups, signals, and exported NodePath references so scripts survive reorganization. - Use Case: When building a level with enemies, props, and lighting, structure it with Enemies, Props, and Level wrapper nodes so operations like "remove all enemies" become a single node removal, and repeated crates become instances of one crate.tscn. ## Quick Start Ask the agent to restructure the current level scene so enemies, props, and level geometry each sit under their own wrapper node with reusable setups extracted into sub-scenes.

Frequently Asked Questions about scene-hierarchy-design

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

FAQPage Schema
How do I structure a scene hierarchy in Summer Engine?

Structure scenes by access pattern: group nodes operated on together under one wrapper parent, keep nodes queried by type as flat siblings, and keep unique nodes like cameras inline. Read the scene tree with summer_get_scene_tree before making any changes.

When should I use a sub-scene instead of inline nodes in Godot?

Extract a setup into its own .tscn sub-scene whenever the same cluster appears two or more times, then instantiate it with summer_instantiate_scene. One-off nodes like a level-specific light or main camera stay inline under the root.

Why do my scripts break when I reorganize the scene tree?

Scripts break because they hardcode deep node paths like ./World/Enemies/Grunt_01/Weapon, which change on any reorganization. Use groups, signals, or exported NodePath references instead so logic stays independent of hierarchy shape.

How do I remove all nodes of one type at once in Summer Engine?

Place all nodes of that type under a single wrapper parent, then call summer_remove_node on the wrapper to remove the entire subtree in one operation. This is why wrapper nodes should match real operation boundaries.

Can I edit .tscn files directly while the engine is running?

No, direct .tscn edits while the engine runs get overwritten when the editor saves. Always mutate scenes through the MCP tools such as summer_add_node, summer_instantiate_scene, and summer_remove_node, passing the exact scenePath.

When should I not use this scene hierarchy approach?

Do not use it for shader or material work, asset import mechanics, or gameplay tuning, since it covers only hierarchy shape. Also avoid over-grouping: wrapping every node in its own container adds depth without enabling any real subtree operation.