unity-scene-optimizer

Dev-GOM's avatarfrom Dev-GOM

Analyzes scenes for performance bottlenecks (draw calls, batching, textures, GameObjects). Use when optimizing scenes or investigating performance issues.

⭐29stars🔀3forks📁View on GitHub🕐Updated Dec 2, 2025

When & Why to Use This Skill

The Unity Scene Optimizer is a specialized Claude skill designed to enhance game performance by identifying and resolving critical bottlenecks. It provides deep analysis of draw calls, batching, texture compression, and GameObject hierarchies. By offering platform-specific targets for mobile, PC, and console, it helps developers achieve optimal frame rates and efficient resource management throughout the development lifecycle.

Use Cases

  • Mobile Performance Tuning: Optimize scenes for mobile devices by reducing draw calls and configuring ASTC/ETC2 texture compression to meet strict hardware limitations and maintain high FPS.
  • Rendering & Batching Optimization: Identify GPU bottlenecks related to excessive triangles or unoptimized lighting and implement static batching or material consolidation to improve rendering efficiency.
  • Memory Management & Asset Audit: Audit texture memory usage and GameObject nesting to prevent memory-related crashes and improve loading times on memory-constrained platforms.
  • Automated Performance Reviews: Use the skill to validate scene metrics against technical budgets for triangles, lights, and draw calls before final builds or platform porting.
nameUnity Scene Optimizer
descriptionAnalyzes scenes for performance bottlenecks (draw calls, batching, textures, GameObjects). Use when optimizing scenes or investigating performance issues.
allowed-toolsRead, Grep, Glob

Unity Scene Optimizer

Analyzes Unity scenes and provides performance optimization recommendations for rendering, physics, memory, and platform-specific concerns.

What This Skill Analyzes

1. Rendering Performance

Analyzes draw calls (target: <100 mobile, <2000 desktop), identifies batching opportunities, recommends material consolidation and static batching.

2. Texture Optimization

Reviews compression formats (BC7/ASTC), mipmap usage, texture atlasing, and platform-specific import settings.

3. GameObject Hierarchy

Targets: <500 GameObjects mobile, <2000 desktop. Identifies deep nesting, recommends object pooling and LOD groups.

4. Lighting and Shadows

Recommends baked lighting over realtime (1-2 lights mobile, 3-4 desktop), minimal shadow-casting lights.

5. Physics Optimization

Analyzes Rigidbody count, collider complexity, collision matrix configuration. Recommends simple colliders over Mesh colliders.

6. Mobile-Specific

Platform targets: 60 FPS iOS (iPhone 12+), 30-60 FPS Android. See mobile-checklist.md for complete requirements.

Optimization Workflow

  1. Measure: Frame Debugger, Stats, Profiler metrics
  2. Identify: GPU/CPU/Memory/Physics bottlenecks
  3. Apply: Quick wins (static batching, compression) → Medium (atlases, pooling, LOD) → Major (hierarchy refactor, culling)
  4. Validate: Compare before/after metrics

See optimization-workflow.md for detailed steps and timelines.

Platform-Specific Targets

Platform Draw Calls Triangles Texture Memory Lights
Mobile Low <50 <20k <100MB 1
Mobile Mid <100 <50k <250MB 1-2
Mobile High <150 <100k <500MB 2-3
PC Low <500 <200k <1GB 3-4
PC Mid <1000 <500k <2GB 4-6
PC High <2000 <1M <4GB 6-8
Console <1000 <800k <3GB 4-6

Tools Reference

Frame Debugger, Profiler, Stats Window, Memory Profiler. See tools-reference.md for usage and commands.

Output Format

Provides: Current metrics, bottleneck identification, prioritized recommendations, performance impact estimates, implementation steps.

When to Use vs Other Components

Use this Skill when: Analyzing scene performance, identifying bottlenecks, or getting optimization recommendations

Use @unity-performance agent when: Implementing complex optimizations, profiling at runtime, or troubleshooting specific performance issues

Use @unity-architect agent when: Redesigning scene architecture, implementing object pooling systems, or planning large-scale optimizations

Use /unity:optimize-scene command when: Running comprehensive scene analysis with detailed reports

  • unity-script-validator: For script-level performance issues
  • unity-template-generator: For optimized component templates