unity-perception

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

2|Updated May 18, 2026
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-perception-pcone-mm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-perception
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/perception
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-perception-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before editing a Unity project, AI agents and developers often lack reliable context about scene structure, project stack, and script dependencies, leading to blind edits and broken references. This Skill provides read-only analysis so you can understand an unfamiliar scene or audit project health without changing anything. ## Core Features & Use Cases - Scene Analysis & Health Checks: Summarize scene structure, detect deep hierarchies, empty nodes, missing scripts, and duplicate names with skills like scene_analyze, scene_health_check, and scene_find_hotspots. - Project & Script Inspection: Detect render pipeline, input system, UI framework, and packages via project_stack_detect, and trace script dependency closures with script_dependency_graph. - Context Export & Reporting: Export structured hierarchy, components, and references with scene_context, or write a durable markdown report to disk with scene_export_report. - Use Case: When joining an unfamiliar Unity project, run scene_analyze and project_stack_detect first to get a full diagnosis of the scene and tech stack before making any edits. ## Quick Start Ask the AI to analyze the current Unity scene and report its structure, health issues, and project stack before making any changes.

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 structure before editing?

Use scene_analyze for a broad diagnosis combining summary, findings, warnings, and recommendations, or scene_summarize for a quick overview of object counts and top components. Both are read-only and safe to run in any approval mode.

How to detect which render pipeline and packages a Unity project uses?

Run project_stack_detect to identify the render pipeline, input system, UI framework, installed packages, test setup, and folder conventions. It takes no parameters and returns a structured stack report.

What is the difference between scene_summarize, scene_analyze, and scene_health_check?

scene_summarize gives a fast overview of counts and top components, scene_analyze provides full diagnosis with recommendations and next-skill hints, and scene_health_check focuses on hygiene red flags like missing scripts and duplicate names.

Can I check if deleting a Unity object breaks other scene references?

Yes, use scene_dependency_analyze with the target object path to map which objects reference it. For script-level impact, script_dependency_graph shows the N-hop class dependency closure instead.

Does scene_export_report modify my Unity project?

It writes a markdown report file to disk, defaulting to Assets/Docs/SceneReport.md, so it is marked as mutating assets and requires grant approval in Approval mode. All other 17 skills in this module are read-only.

Why does perception_analyze or perception_scan not work?

Those skill names do not exist in this module. Use the actual skill names such as scene_analyze, scene_health_check, or scene_context, and fetch exact signatures from the skills schema endpoint.