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.