scene-optimizer

Analyze Godot .tscn scene files for structural and performance issues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cautiouskurns/Blood-and-Gold --skill scene-optimizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scene-optimizer
Source: https://github.com/cautiouskurns/Blood-and-Gold/tree/main/.claude/skills/scene-optimizer
Command: npx skills add https://github.com/cautiouskurns/Blood-and-Gold --skill scene-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps Godot developers quickly identify structural and performance issues in scene files (.tscn), reducing debugging time and improving runtime efficiency.

Core Features & Use Cases

  • Structural analysis: scans node hierarchies for depth, naming, and organization problems.
  • Performance checks: flags heavy nodes, large node counts, and inefficient resource usage.
  • Signal and resource validation: detects broken connections and missing resources.
  • Use Case: Imagine a complex scene with 120 nodes and nested wrappers; this Skill highlights depth and organization issues and suggests refactors to simplify the tree.

Quick Start

Use the scene-optimizer skill to analyze a target .tscn file, such as 'res://Scenes/Main.tscn', and receive a prioritized report of issues and fixes.

Frequently Asked Questions about scene-optimizer

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

FAQPage Schema
How do I analyze Godot scene files for performance issues?

To analyze Godot scene files for performance issues, you can scan a target .tscn file to identify structural problems, heavy nodes, and inefficient resource usage. This process delivers a prioritized, actionable report highlighting issues and fixes.

What causes a high node count or deep hierarchy to slow down a Godot scene?

A high node count or deep hierarchy slows down a Godot scene by creating structural bottlenecks. Analyzing the .tscn file helps identify these nested wrappers and large node counts, suggesting refactors to simplify the tree and improve runtime efficiency.

Can I use this scene analysis on Godot 4.x projects?

Yes, you can use this scene analysis on Godot 4.x projects. It is specifically designed to diagnose scene hierarchies, resource usage, signals, and potential bottlenecks within the Godot 4.x development environment.

How do I find broken signal connections in a Godot .tscn file?

To find broken signal connections in a Godot .tscn file, you perform a signal and resource validation scan. This detects broken connections and missing resources, delivering a report of the issues for debugging.

What is the best way to optimize a complex Godot scene tree?

The best way to optimize a complex Godot scene tree is to analyze the .tscn file for depth, node count, and common Godot pitfalls. This provides a prioritized report that highlights refactoring opportunities to streamline the scene for speed.