unity-perception

Analyze Unity scenes and export structured reports of hierarchy and dependencies.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/krl76/MP-Study-Projects --skill unity-perception-krl76
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/krl76/MP-Study-Projects/tree/main/Practice1/.codex/skills/unity-skills/skills/perception
Command: npx skills add https://github.com/krl76/MP-Study-Projects --skill unity-perception-krl76

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scene understanding and analysis for Unity projects, enabling fast overviews, dependency reports, and export-ready scene state.

Core Features & Use Cases

  • Scene summarization and overview: quick counts, hierarchy insight, and top components.
  • Health checks & hotspot detection: identify deep hierarchies, empty nodes, and potential issues affecting gameplay and performance.
  • Exports & reporting: generate structured scene reports and dependency insights for collaboration and handoff.

Quick Start

Generate a quick scene summary and export a report for the current Unity scene.

Frequently Asked Questions about unity-perception

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

FAQPage Schema
How do I summarize a Unity scene hierarchy and components?

To summarize a Unity scene, the skill analyzes the hierarchy, components, and dependencies to provide a structured overview. It uses current editor context to identify object counts, hierarchy depth, and top components.

Can I generate a dependency report for my Unity project?

Yes, you can generate a dependency report for your Unity project using the script dependency graph feature. This identifies code dependencies and provides export-ready scene state insights for collaboration and handoff.

What is the best way to detect performance hotspots in a Unity scene?

The best way to detect performance hotspots in a Unity scene is by running a health check. This identifies deep hierarchies and empty nodes that affect gameplay and performance, providing a structured overview of potential issues.

How do I export a structured report of my Unity scene state?

You export a structured report of your Unity scene state by using the skill's reporting features. It generates dependency insights and scene summaries, creating an export-ready overview for project context and team handoffs.

Does this scene analysis tool work with empty GameObjects?

Yes, the scene analysis tool works with empty GameObjects by detecting them during health checks. It identifies empty nodes within the hierarchy that may cause potential issues affecting gameplay and overall project performance.

How do I find specific objects in a complex Unity scene?

You find specific objects in a complex Unity scene by using object search functions. The skill supports scene object searches and gameobject find operations to locate elements within the current hierarchy for analysis.