unity-perception

Generate structured Unity scene summaries and markdown dependency reports.

8|1|Updated Oct 7, 2025
One-click install
npx skills add https://github.com/Zzulin/unity-project01 --skill unity-perception-zzulin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/Zzulin/unity-project01/tree/main/URP1/Plugins/Unity-Skills-main/SkillsForUnity/unity-skills~/skills/perception
Command: npx skills add https://github.com/Zzulin/unity-project01 --skill unity-perception-zzulin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides automated understanding and actionable summaries of Unity scenes so developers and technical reviewers can quickly grasp scene composition, find cross-object references, and locate code-level dependencies without manual inspection.

Core Features & Use Cases

  • Structured scene summaries with object and component counts, active object statistics, and top component lists for fast audits.
  • Hierarchy exports and comprehensive scene_context snapshots that include components, serialized values, and cross-object references for AI-assisted coding or documentation.
  • Script-level analysis and dependency graphs to support safe refactoring, impact analysis, and generation of markdown reports combining scene data and regex-based C# code dependency extraction.
  • Use case: generate a SceneReport.md that lists the hierarchy, user script fields with values, and merged code+scene dependency graph to prepare for a refactor or performance pass.

Quick Start

Export a complete scene report including hierarchy, user script fields, and code dependency analysis by running scene_export_report and saving to Assets/Docs/SceneReport.md.

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 dependency report for a Unity scene?

You can generate a Unity scene dependency report by applying scene analysis to extract hierarchy summaries, component inventories, and cross-object references, then exporting the consolidated data into a markdown file.

What is scene analysis and how does it help with Unity refactoring?

Scene analysis provides automated summaries of Unity scene composition and cross-object references, helping developers quickly locate script dependencies and understand component counts without manual inspection before refactoring.

Can I analyze C# script dependencies and scene references together?

Yes, you can analyze C# script dependencies and scene references together by combining scene data with regex-based code dependency extraction to generate a merged dependency graph for impact analysis.

Does Unity scene analysis require access to project source files?

Yes, Unity scene analysis requires access to the scene hierarchy, serialized object fields, and project C# source files to perform accurate component counts, reference tracing, and code dependency analysis.

How do I export a Unity scene hierarchy and component inventory to markdown?

You export a Unity scene hierarchy and component inventory to markdown by running the scene export report function, which generates a SceneReport.md containing structured summaries and serialized user script fields.

What is the best way to audit Unity scene performance and component usage?

The best way to audit Unity scene performance and component usage is to generate a structured scene summary that provides active object statistics, top component lists, and performance hints for fast technical review.