What is unity-perception?

A read-only Unity analysis toolkit that summarizes scenes and projects, reports dependencies, checks scene health, and exports scene state. A scene is a saved level or editor view containing game objects and their components.

Use it to analyze scene and project health, inspect hierarchies and references, build script dependency reports, find objects, and review component or project statistics.

It helps inspect project structure and find issues without changing the scene or project.

unity-perception — Skill for Claude Code and Codex by batihandev

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add batihandev/unity-mcp-skills --skill perception

Clone the repo

git clone --depth 1 https://github.com/batihandev/unity-mcp-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/batihandev/unity-mcp-skills/perception/github.svg)](https://agentmods.dev/skills/batihandev/unity-mcp-skills/perception)

Your own site

<a href="https://agentmods.dev/skills/batihandev/unity-mcp-skills/perception"><img src="https://agentmods.dev/badge/skills/batihandev/unity-mcp-skills/perception/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/batihandev/unity-mcp-skills/perception"><img src="https://agentmods.dev/badge/skills/batihandev/unity-mcp-skills/perception.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 26 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,481 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00026	$0.01481
Opus 5.5	$0.00010	$0.00592
Sonnet 5.5	$0.00005	$0.00296
Haiku 4.5	$0.00003	$0.00148

Measured 1mo ago against content hash 570c851761d5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

unity-perception scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/perception/SKILL.md · 139 lines

How it starts

The opening of the file, as written. The whole thing — 139 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Unity Perception Skills

Overview

Use this module for read-only scene and project analysis. It is available in Semi-Auto by default.

Common Mistakes

DO NOT (common hallucinations):

perception_analyze, perception_scan, and perception_describe do not exist
scene_context is not editor_get_context: it exports hierarchy/components/references, while editor context focuses on current editor state
scene_analyze, scene_health_check, scene_contract_validate, scene_component_stats, scene_find_hotspots, and project_stack_detect belong to this module even if the prefix looks like scene_* or project_*

Routing:

Current selection/play-mode/editor state -> editor_get_context
Object search by name/path -> scene_find_objects or gameobject_find
Script dependency closure -> script_dependency_graph

Skills

Scene Health and Summary

Skill	Use	Key parameters
`scene_analyze`	Combined scene + project analysis	`topComponentsLimit?`, `issueLimit?`, `deepHierarchyThreshold?`, `largeChildCountThreshold?`
`scene_health_check`	Read-only health report	`issueLimit?`, `deepHierarchyThreshold?`, `largeChildCountThreshold?`
`scene_summarize`	Structured scene summary	`includeComponentStats?`, `topComponentsLimit?`
`scene_component_stats`	Component and facility stats	`topComponentsLimit?`
`scene_find_hotspots`	Deep hierarchy / large group / empty node hotspots	thresholds + `maxResults?`
`scene_tag_layer_stats`	Tag/layer usage	none
`scene_performance_hints`	Prioritized optimization hints	none

Scene Snapshots and Exports

Skill	Use	Key parameters
`scene_diff`	Capture or compare lightweight snapshots	`snapshotJson?`
`hierarchy_describe`	Return text hierarchy tree	`maxDepth?`, `includeInactive?`, `maxItemsPerLevel?`
`scene_context`	Export hierarchy, components, references	`maxDepth?`, `maxObjects?`, `rootPath?`, `includeValues?`, `includeReferences?`, `includeCodeDeps?`
`scene_export_report`	Save markdown scene report	`savePath?`, `maxDepth?`, `maxObjects?`
`scene_dependency_analyze`	Analyze impact / dependency graph in-scene	`targetPath?`, `savePath?`

Read the full file on GitHub · 139 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago First seen · 139 lines · 26 tokens per session scan A 570c851761d5

Subscribe to this mod's changes

unity-perception is a skill published in the GitHub repository batihandev/unity-mcp-skills (6 stars, last pushed 12d ago), licensed MIT. It adds 26 tokens to every session and 1,481 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

C# and .NET ai-agents ai-tooling editor-automation mcp skills

migrate-mstest-v3-to-v4

Use this skill before answering, planning, or editing any MSTest 3.x-to-4.x upgrade or post-upgrade failure. Triggers include "MSTest v4 breaking changes"; CS0507/CS0103/CS1061/CS1615; ExecuteAsync, CallerInfo, DisplayName, or custom TestMethodAttribute; ClassCleanupBehavior; ContainsKey; ThrowsExactly or…

managedcode/dotnet-skills · 179 tokens

migrate-xunit-to-mstest

Convert .NET tests from xUnit.net v2/v3 to MSTest v4 while preserving VSTest or MTP. Use for replacing xunit packages, Fact/Theory/InlineData/MemberData, assertions, IClassFixture/ICollectionFixture, ITestOutputHelper, TestContext cancellation, traits/Owner, skips, timeouts, and xUnit parallelization. Also use when a…

managedcode/dotnet-skills · 141 tokens

migrate-xunit-to-xunit-v3

Migrate .NET test projects from xUnit.net v2 to xunit.v3 and fix v3 breaks. Use for package/CPM conversion, OutputType=Exe, preserving the VSTest or MTP runner (including projects currently using YTest.MTP.XUnit2), incompatible TFMs, async void tests, string-to-Type attributes, custom Fact/Theory/BeforeAfterTest…

managedcode/dotnet-skills · 149 tokens

semantic-kernel

Build AI-enabled .NET applications with Semantic Kernel using services, plugins, prompts, and function-calling patterns that remain testable and maintainable. USE FOR: adding AI-driven prompts, plugins, or orchestration to a .NET app; reviewing kernel construction, service registration, or plugin usage; building…

managedcode/dotnet-skills · 116 tokens

wpf

Build and modernize WPF applications on .NET with correct XAML, data binding, commands, threading, styling, and Windows desktop migration decisions. USE FOR: working on WPF UI, MVVM, binding, commands, or desktop modernization; migrating WPF from .NET Framework to .NET; integrating newer Windows capabilities into a…

managedcode/dotnet-skills · 122 tokens

worker-services

Build long-running .NET background services with BackgroundService, Generic Host, graceful shutdown, configuration, logging, and deployment patterns suited to workers and daemons. USE FOR: background services; scheduled workers; hosted services; worker extraction; graceful shutdown, health checks, and service hosting…

managedcode/dotnet-skills · 109 tokens