skills.rest
pikachu0310
pikachu0310COMMUNITY
Explore all skills by this author →
Website𝕏@pikachu0310mainGitHub

unity-perception

Analyze Unity scenes, projects, and scripts with read-only inspection skills.

Updated Aug 31, 2026
Search Tags:#game development#unity#scene analysis#health check#dependency graph#read-only#context export
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-perception-pikachu0310
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/perception
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-perception-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents editing Unity projects often lack reliable context about scene structure, component usage, and script dependencies, leading to blind edits and broken references. This module provides 18 read-only analysis skills that gather scene, project, and script context before any modification happens. ## Core Features & Use Cases - Scene Analysis: Summarize scenes, run health checks, find hotspots like deep hierarchies or empty nodes, and diff lightweight snapshots. - Context Export: Export hierarchy, components, references, and optional code dependencies as structured context for downstream AI steps, or save a markdown scene report to disk. - Project and Script Analysis: Detect render pipeline, input, UI, packages, and test setup, analyze individual MonoBehaviour or ScriptableObject classes, and compute N-hop script dependency closures. - Use Case: Before refactoring a Unity feature, call scene_analyze for a broad diagnosis, script_dependency_graph to see which scripts must change, and scene_dependency_analyze to check what breaks if an object is deleted. ## Quick Start Ask the agent to run scene_analyze on the current Unity scene and summarize the findings, warnings, and suggested next skills.

Frequently Asked Questions about unity-perception

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a Unity scene before editing it?▼

Call scene_analyze for a combined scene and project diagnosis returning summary, findings, warnings, and recommendations. For a faster overview use scene_summarize, and for hygiene red flags like missing scripts or deep hierarchies use scene_health_check.

What is the difference between scene_context and hierarchy_describe?▼

hierarchy_describe returns a lightweight human-readable text tree of the scene. scene_context exports structured hierarchy, components, references, and optional code dependencies, making it the right choice when another AI step needs full machine-readable scene context.

How do I check what breaks if I delete a Unity object?▼

Use scene_dependency_analyze with the target object path to see in-scene references that depend on it. Omit the savePath parameter to get the analysis in the response without writing any file to disk.

Does scene_dependency_analyze modify my Unity project?▼

Only if you pass savePath. With savePath it creates a directory, writes a markdown report, and imports it as a project asset, so it is flagged mutatesAssets. Without savePath it performs a pure read-only analysis.

How do I find which scripts to change for a Unity feature?▼

Call script_dependency_graph with the script class name to get an N-hop dependency closure showing which scripts are connected. Use script_analyze first if you need details on a single MonoBehaviour or ScriptableObject class.

Why does scene_export_report need approval in Approval mode?▼

scene_export_report writes a markdown file to disk and is flagged mutatesAssets, so it runs as FullAuto rather than SemiAuto. In Approval mode it requires a grant, while the other 17 read-only skills execute directly in all three modes.

Related Skills

Explore More Software Engineering Skills→
Dylan8865Dylan8865

unity-scene

Create, load, save, and inspect Unity scenes and their GameObject hierarchies.

Community
Intermediate
du-qwqdu-qwq

unity-perception

Analyze Unity scenes, project stacks, and scripts with read-only inspection tools.

Community
Intermediate
dyCuong03dyCuong03
6

unity-editor

Control Unity Editor play mode, pause, selection, and menu commands.

Community
Intermediate
Dylan8865Dylan8865

unity-perception

Analyzes Unity scenes, project stacks, and scripts with read-only inspection skills.

Community
Intermediate