unity-perception

Summarize Unity scenes into JSON, text hierarchy, and script API analysis.

1.6k|152|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/Besty0728/Unity-Skills --skill unity-perception
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/Besty0728/Unity-Skills/tree/main/unity-skills/skills/perception
Command: npx skills add https://github.com/Besty0728/Unity-Skills --skill unity-perception

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps AI quickly understand and describe the current Unity scene, avoiding manual inspection and enabling faster iteration.

Core Features & Use Cases

  • Scene Summary: Generate a concise overview of the active scene, including scene name, object counts, and top components.
  • Hierarchy Description: Produce a readable text tree of the scene's hierarchy for quick comprehension.
  • Script Analysis: Inspect MonoBehaviour scripts to reveal public API and Unity callbacks.
  • Use Case: On a new scene, quickly summarize state and identify hot spots to optimize performance or plan changes.

Quick Start

Invoke scene_summarize to fetch a scene overview, then use hierarchy_describe to visualize structure, and finally run script_analyze for a specific script.

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 summary of a Unity scene for AI analysis?▼

To generate a Unity scene summary for AI analysis, invoke the scene_summarize function to produce a JSON overview containing the sceneName, object stats, and top components.

Can I visualize the hierarchy of my Unity scene as a text tree?▼

Yes, you can visualize the Unity scene hierarchy as a readable text tree by using the hierarchy_describe function, which outputs the structural hierarchy for quick comprehension.

What is the best way to inspect MonoBehaviour scripts and public APIs in Unity?▼

The best way to inspect MonoBehaviour scripts is by running the script_analyze function, which reveals public API details and Unity callbacks for rapid state capture and auditing.

Does AI-driven scene understanding require manual inspection of Unity objects?▼

AI-driven scene understanding avoids manual inspection of Unity objects by generating a JSON scene summary, a text hierarchy tree, and script API analysis for faster iteration.

How to identify performance hot spots in a new Unity scene?▼

To identify performance hot spots in a new Unity scene, generate a concise scene overview using scene_summarize and review the top components and object stats to plan optimizations.

What format does the Unity scene summary output use for documentation?▼

The Unity scene summary outputs a JSON format containing sceneName, stats, and topComponents, alongside a text hierarchy and script API details for scene auditing and documentation.