unity-perception

Analyze Unity scenes and export structured reports.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/jinluli/EnglishLearnTool --skill unity-perception-jinluli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/jinluli/EnglishLearnTool/tree/main/Packages/SkillsForUnity/unity-skills~/skills/perception
Command: npx skills add https://github.com/jinluli/EnglishLearnTool --skill unity-perception-jinluli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Unity, C#, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Unity Perception provides a comprehensive analysis of Unity scenes, offering insights into scene structure, components, and more. It solves the problem of manually analyzing complex scenes by automating the process and providing actionable data.

Core Features & Use Cases

  • Scene Summary: Obtain a structured summary of the current scene, including object counts, component types, and more.
  • Hierarchy Analysis: Get a text tree of the scene hierarchy, including active and inactive objects.
  • Script Analysis: Analyze MonoBehaviour scripts for public API, including fields, properties, and methods.
  • Spatial Query: Find objects within a radius of a point or near another object.
  • Material Overview: Get an overview of all materials and shaders used in the scene.
  • Scene Context: Generate a comprehensive scene snapshot for AI coding assistance.
  • Export Report: Export complete scene structure and script dependency report as a markdown file.
  • Dependency Analysis: Analyze object dependency graph and impact of changes.
  • Dependency Graph: Return the N-hop dependency closure of an entry script.
  • Tag/Layer Stats: Get Tag/Layer usage stats and find potential issues.
  • Performance Hints: Diagnose scene performance issues with prioritized actionable suggestions.

Quick Start

Use the unity-perception skill to get a summary of the current scene.

Frequently Asked Questions about unity-perception

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

FAQPage Schema
How do I analyze a complex Unity scene to understand its hierarchy and dependencies?

Unity scene analysis automates hierarchy mapping, script dependency analysis, and component summarization. It generates structured text trees and dependency graphs to reveal object relationships and change impacts without manual inspection.

Can I get a summary of all materials and shaders used in my Unity scene?

Yes, material overview functionality scans the current Unity scene to compile a comprehensive list of all applied materials and shaders. This provides an actionable overview to manage assets and identify rendering inconsistencies.

Does this scene analysis tool require C# scripts to diagnose performance issues?

Yes, scene analysis requires Unity and C# for scene manipulation and script analysis. It diagnoses performance issues by evaluating MonoBehaviour scripts and tag/layer stats to provide prioritized actionable suggestions.

What is the best way to find inactive objects within a Unity scene hierarchy?

The best way to find inactive objects is using hierarchy analysis, which generates a complete text tree of the Unity scene. This includes both active and inactive objects, ensuring full visibility into scene structure.

How do I export a Unity scene structure and script dependency report?

You can export a complete scene structure and script dependency report as a markdown file. This export feature captures the full hierarchy and dependency graph, providing a shareable snapshot for documentation and review.

How does dependency graph analysis work for Unity MonoBehaviour scripts?

Dependency graph analysis returns the N-hop dependency closure of an entry script. By evaluating MonoBehaviour public APIs, it maps how changes to one script impact connected objects within the Unity scene.