unity-perception

Analyze active Unity scenes to generate summaries, hierarchy snapshots, and dependency reports.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-perception-mandexonla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/mandexonla/Top-Down-Template/tree/main/.codex/skills/unity-skills/skills/perception
Command: npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-perception-mandexonla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scene understanding and analysis for Unity projects—getting quick, actionable insights about the current scene to inform debugging, design reviews, and documentation.

Core Features & Use Cases

  • Scene summary (scene_summarize): produce structured scene stats and top components.
  • Hierarchy and references (hierarchy_describe, scene_export_report): visualize object trees and export references.
  • Script analysis (script_analyze): inspect public API of MonoBehaviours.
  • Scene context and exports (scene_context, scene_export_report): generate a snapshot of scene state for AI-assisted coding and documentation.
  • Use Case: When preparing a design review, generate a full scene report including hierarchy, component counts, and key dependencies.

Quick Start

Ask for a concise scene overview using scene_summarize for the active 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 generate a structured summary of my active Unity scene?

To generate a Unity scene summary, trigger the scene_summarize command during an editor session to produce structured scene stats and a list of top components. This provides a quick snapshot of the current scene state for debugging or design reviews.

Can I export a Unity scene hierarchy and dependency report for documentation?

Yes, you can export a Unity scene hierarchy and dependencies by using the scene_export_report trigger. It visualizes the object tree, exports references, and generates component-level insights suitable for documentation and design review preparation.

What is the best way to analyze MonoBehaviour scripts and public APIs in a Unity project?

The best way to analyze MonoBehaviour scripts is to use the script_analyze trigger, which inspects the public API of your scripts. This helps identify dependencies and component interactions within the active Unity scene graph.

Does Unity scene analysis work without manual setup of the scene graph?

Unity scene analysis requires direct access to the scene graph, component metadata, and basic script dependencies to function. Once these are available in the editor session, it automatically extracts hierarchy snapshots and dependency reports without manual configuration.

How do I get a quick object tree snapshot for a Unity design review?

To get an object tree snapshot for a Unity design review, use the hierarchy_describe trigger to visualize the hierarchy and component counts. This provides a concise overview of object relationships and scene structure to inform your review.