unity-perception

Analyze Unity scenes and projects read-only for AI coding guidance.

6|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/dyCuong03/unity-agent-team --skill unity-perception-dycuong03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/dyCuong03/unity-agent-team/tree/main/.claude/skills/unity-skills/skills/perception
Command: npx skills add https://github.com/dyCuong03/unity-agent-team --skill unity-perception-dycuong03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of getting reliable, read-only Unity project and scene intelligence so AI can make accurate, low-risk coding decisions without guessing.

Core Features & Use Cases

  • Scene health and diagnosis: Detect hierarchy issues, hotspots, deep/large groups, and other hygiene signals while staying read-only for the first analysis pass.
  • Structured context export: Export hierarchy, components, references, and optional code dependency hints into an AI-friendly markdown report.
  • Targeted queries for debugging: Answer “what’s in the scene?”, “what depends on what?”, “what’s near this location?”, and “what scripts/packages are involved?”

Quick Start

Ask the AI to generate a full AI-ready snapshot by running scene_context to export hierarchy/components/references for the current 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 export a Unity scene hierarchy and component data for AI analysis?

You can export a Unity scene hierarchy and component data by running a scene context command to generate a structured markdown report of references and components. This provides AI-ready spatial and hierarchy intelligence for coding guidance.

Can I check if a Unity GameObject is safe to delete without breaking dependencies?

Yes, you can perform a safe-to-delete impact assessment by analyzing the read-only dependency graph and reference structure of the Unity scene. This identifies what depends on the target object before you make deletion edits.

What is the best way to analyze Unity scene health and detect deep hierarchy issues?

The best way to analyze Unity scene health is to run a read-only inspection pass that detects deep hierarchy groups and hygiene hotspots. This diagnosis evaluates structural issues while ensuring no scene modifications occur.

Does this Unity scene analysis approach support script dependency graph queries?

Yes, this approach supports script dependency graph closure queries to identify involved packages and code dependencies. It validates scene conventions and traces script references within the project for accurate refactoring planning.

How do I generate a snapshot diff for Unity scene refactoring planning?

You generate a snapshot diff by exporting structured scene context before and after your planned Unity edits. This workflow validates scene conventions and captures dependency insights to ensure low-risk refactoring outcomes.

Can I query what Unity objects are near a specific spatial location in my scene?

Yes, you can execute targeted spatial queries against the exported Unity scene context to identify objects near a specific location. This read-only inspection provides material and spatial data for debugging and analysis.