From Unity MCP
Use Karnelian Unity MCP from Claude Code. Invoke when the user asks Claude to inspect or edit a Unity project through the Unity Editor.
How this skill is triggered — by the user, by Claude, or both
Slash command
/unity-mcp:unity-mcpThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use this plugin when working on Unity projects through the Unity Editor.
Use this plugin when working on Unity projects through the Unity Editor.
The Claude Code plugin starts the MCP server automatically, but each Unity project still needs the Unity Editor package installed once.
From the Unity project root, run:
npx -y github:karnelian/unity-mcp setup --profile=core
For UI-heavy projects:
npx -y github:karnelian/unity-mcp setup --profile=core,ui
For 2D projects:
npx -y github:karnelian/unity-mcp setup --profile=core,2d
For all tools during broad debugging:
npx -y github:karnelian/unity-mcp setup --profile=full
Then open Unity and start the KarnelLabs MCP server window if it is not already listening.
unity_project_health for a compact project snapshot.unity_script_writeAndCompile for C# script writes, then follow with unity_script_compileCheck or unity_project_health if Unity is still compiling.unity_debug_visualQaBundle for visual/editor-state debugging instead of repeated individual screenshots.core by default and add groups like ui, 2d, xr, rendering, or cinemachine only when needed.core: normal Unity editing, scripts, scenes, assets, validation, workflow tools.core,ui: uGUI / UI Toolkit / TextMeshPro work.core,2d: sprite, tilemap, 2D physics, 2D animation.core,xr,rendering: Quest/XR and render-pipeline tuning.full: temporary broad exploration/debugging only.Use these Claude Code commands as the default operating loops:
/unity-mcp:unity-project-scout — first pass on unfamiliar projects; read-only stack/convention scan./unity-mcp:unity-health-check — compact health snapshot before mutation./unity-mcp:unity-compile-fix — C# compile-error loop using unity_script_writeAndCompile; C# only./unity-mcp:unity-visual-qa — Console/Hierarchy/Inspector/Game/Scene visual QA bundle./unity-mcp:unity-ui-qa — focused UI/canvas/UI Toolkit/TextMeshPro QA./unity-mcp:unity-scene-contract — playable-scene contract validation./unity-mcp:unity-package-risk — package/version/optional dependency risk scan./unity-mcp:unity-mobile-check — Android/iOS/Quest readiness check./unity-mcp:unity-performance-scan — read-only performance risk scan./unity-mcp:unity-build-smoke — build-smoke plan or explicit minimal build run./unity-mcp:unity-test-run — Unity test discovery/run flow./unity-mcp:unity-prefab-audit — prefab/override/missing-reference audit./unity-mcp:unity-refactor-plan — script refactor plan using design guardrails; plan only.Default sequence for feature work:
unity-project-scout for unfamiliar projects.unity-health-check before edits.unity-compile-fix until clean.unity-scene-contract and unity-visual-qa for scene/visual work.unity-performance-scan, unity-mobile-check, or unity-build-smoke before platform validation.Load these on demand before non-trivial decisions:
unity-project-scout-guide — project conventions and stack discovery.unity-scene-contracts-guide — scene wiring and playable-scene requirements.unity-performance-guide — performance review and measurement-first guidance.unity-mobile-guide — Android/iOS/Quest constraints.unity-script-design-guide — class roles, testability, serialized API safety.unity-safety-risk-guide — dry-run, confirmation, rollback, and validation rules.After this repository is added as a Claude Code marketplace:
claude plugin marketplace add karnelian/unity-mcp
claude plugin install unity-mcp@karnelian-unity-mcp -s user
Restart Claude Code after installing or updating the plugin.
Provides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub karnelian/unity-mcp --plugin unity-mcp