unity-perception

Analyze Unity scenes and export structured summaries and dependency reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides fast, structured understanding of Unity scenes so developers can find inter-object references, surface risky dependencies, and generate exportable reports for refactoring, debugging, or documentation.

Core Features & Use Cases

  • Scene Summaries: Aggregated counts (objects, components, cameras, lights) and top component lists to quickly assess scene composition.
  • Hierarchy & Spatial Queries: Text-tree exports, subtree selection, and radius-based object searches to locate relevant gameobjects.
  • Script & Code Analysis: MonoBehaviour API introspection, script dependency graphs, and regex-based C# code dependency extraction to plan safe changes.
  • Reports & Diagnostics: Exportable markdown reports with hierarchy, script fields, code dependencies, and prioritized performance hints for optimization.
  • Use Case: Prepare a comprehensive scene report before a large refactor to identify which scripts, objects, or systems will be affected.

Quick Start

Provide a scene summary with top components and component counts for the currently loaded 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 Unity scene to find script dependencies and object references?

You can generate a Unity scene summary by applying the skill to the editor context to extract aggregated counts for objects, components, cameras, and lights. It also provides top component lists to help you quickly assess scene composition and structure.

How do I export a Unity hierarchy tree and scene report to markdown or JSON?

You can export a text-tree hierarchy and scene diagnostics to markdown or JSON formats. The exportable report includes script fields, code dependencies, tag and layer statistics, and prioritized performance hints for optimization and documentation.

Can I query gameobjects spatially by radius within a Unity scene?

Yes, you can perform radius-based spatial queries to locate relevant gameobjects within a Unity scene. The skill also supports text-tree exports and subtree selection to help you navigate and isolate specific hierarchy sections.

What is the best way to prepare a Unity scene for a large refactor?

The best way to prepare for a large refactor is to generate a comprehensive scene report covering script dependency graphs, MonoBehaviour fields, and code dependencies. This identifies affected scripts, objects, and systems before making structural changes.

Does this Unity scene analysis tool work with prefabs and provide performance hints?

Yes, the tool analyzes both Unity scenes and prefabs, extracting component statistics and generating prioritized performance hints. It surfaces risky dependencies and optimization opportunities for complex scene compositions.

What are the limitations of regex-based C# dependency analysis in Unity?

Regex-based C# dependency analysis relies on pattern matching rather than full semantic compilation, meaning it may miss dynamically loaded references or reflection-based dependencies. It uses configurable hop limits to constrain graph traversal depth.