unity-perception

Installation
SKILL.md

Unity Perception Skills

Read-only analysis of the open scene, the project and scripts. Parameters come from the schema (GET /skills/schema?category=Perception&wire=v2); execution and dryRun rules: root SKILL.md.

When to use

  • Gathering context before editing an unfamiliar scene or project
  • Auditing scene structure, hygiene or hotspots without changing anything
  • Checking what depends on an object or script before a change
  • Exporting structured scene context for another AI step

Rules

  • 17 skills are SemiAuto and run in every mode without a grant; 16 of them are pure reads.
  • scene_dependency_analyze is SemiAuto but not read-only: passing savePath writes a markdown file and imports it as an asset. Without savePath it returns analysis and markdown in the response and writes nothing. Pass savePath only when the user asked for a file; the response then names it in savedTo.
  • scene_export_report writes a markdown file (default Assets/Docs/SceneReport.md) and is FullAuto: under Approval it needs a grant.
  • No skill here deletes, enters Play Mode or triggers a reload.

Pitfalls

  • scene_context exports hierarchy, components and references for AI coding. It is not editor_get_context, which reports the current editor state.
  • scene_context maxObjects defaults to 200; use rootPath to export one subtree.
Installs
86
GitHub Stars
1.9K
First Seen
Mar 14, 2026