unity-perception

Analyze Unity scene hierarchy, components, and script dependencies into structured JSON or markdown reports.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/lrbjk/FenShen_Remake_V0 --skill unity-perception-lrbjk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/lrbjk/FenShen_Remake_V0/tree/main/.codex/skills/unity-skills/skills/perception
Command: npx skills add https://github.com/lrbjk/FenShen_Remake_V0 --skill unity-perception-lrbjk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides fast, structured understanding of a Unity scene so developers and technical designers can inspect hierarchy, components, script relationships, and scene-level metadata without manual traversal or ad hoc debugging.

Core Features & Use Cases

  • Scene Summaries: Structured scene overviews with object counts, active/root objects, hierarchy depth, and top component statistics.
  • Hierarchy & Spatial Queries: Human-readable tree exports and radius/near-object spatial searches to locate and inspect objects.
  • Script & Dependency Analysis: MonoBehaviour API introspection, script dependency graphs, and deep C# code-level dependency extraction for safe refactoring.
  • Export & Reports: Markdown exports combining hierarchy, script fields, code dependency patterns, and a merged dependency graph with risk ratings.
  • Performance & Tagging Insights: Targeted performance hints and tag/layer usage statistics to prioritize fixes.

Quick Start

Summarize the current Unity scene with component counts and top components by running scene_summarize with includeComponentStats enabled and topComponentsLimit set to 10.

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 Unity scene structure and generate a hierarchy overview?

You can analyze a Unity scene by running scene_summarize with includeComponentStats enabled, which outputs object counts, active root objects, hierarchy depth, and top component statistics into structured JSON or markdown formats.

Can I generate a script dependency graph for Unity MonoBehaviours to plan refactoring?

Yes, Unity script dependency analysis performs MonoBehaviour API introspection and deep C# code-level dependency extraction to build dependency graphs with risk ratings, enabling safe refactoring of your codebase.

What is the best way to export Unity scene metadata and component statistics into a readable report?

Exporting Unity scene metadata is best done by generating markdown reports that combine hierarchy trees, script fields, code dependency patterns, and tag or layer usage statistics with configurable depth and object limits.

How do spatial queries work for finding objects within a radius in a Unity scene?

Spatial queries perform radius and near-object searches within Unity scenes to locate and inspect specific objects, returning human-readable tree exports and object-level metadata for targeted spatial analysis.

Does Unity scene analysis provide performance hints and tag usage statistics?

Yes, Unity scene analysis provides targeted performance hints and tag or layer usage statistics alongside component counts, allowing developers to prioritize scene optimization fixes effectively.