Agent skill
Unity Scene Optimizer
Analyzes scenes for performance bottlenecks (draw calls, batching, textures, GameObjects). Use when optimizing scenes or investigating performance issues.
Install this agent skill to your Project
npx add-skill https://github.com/Dev-GOM/claude-code-marketplace/tree/main/plugins/unity-dev-toolkit/skills/unity-scene-optimizer
SKILL.md
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
- Measure: Frame Debugger, Stats, Profiler metrics
- Identify: GPU/CPU/Memory/Physics bottlenecks
- Apply: Quick wins (static batching, compression) → Medium (atlases, pooling, LOD) → Major (hierarchy refactor, culling)
- 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
Related Skills
- unity-script-validator: For script-level performance issues
- unity-template-generator: For optimized component templates
Didn't find tool you were looking for?