setup-unity

Inspects a Unity project and proposes one pinned Unity MCP adapter with health checks and rollback.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill setup-unity-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-unity
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio-unity/skills/setup-unity
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill setup-unity-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up Unity editor automation requires choosing a compatible MCP adapter, pinning exact versions, and verifying permissions, which is error-prone when done manually. This Skill inspects your Unity project and produces a verified, digest-confirmed installation plan before anything is installed. ## Core Features & Use Cases - Project Inspection: Runs a doctor check covering ProjectVersion.txt, Unity/Hub availability, OS/architecture, Python or Node requirements, existing MCP servers, and uncommitted files. - Pinned Adapter Selection: Defaults to CoplayDev/unity-mcp at an immutable commit, switching to IvanMurzak/Unity-MCP only with documented evidence it satisfies a requirement the default cannot. - Digest-Confirmed Apply: Generates a plan via pack plan, waits for the user to repeat the displayed digest verbatim, then applies with pack apply and finishes with health checks and rollback support. - Use Case: A developer wants AI-driven Unity editor automation; the Skill inspects the project, proposes exactly one pinned adapter with licenses, permissions, and backups, and only installs after explicit digest confirmation. ## Quick Start Ask the assistant to inspect this Unity project and propose one compatible pinned Unity MCP adapter with health checks and rollback.

Frequently Asked Questions about setup-unity

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

FAQPage Schema
How do I set up a Unity MCP server for editor automation?

Run the doctor check first to confirm ProjectVersion.txt, Unity/Hub availability, and OS requirements, then generate a plan with pack plan. The plan is applied only after you repeat the displayed digest verbatim, followed by health checks.

CoplayDev/unity-mcp vs IvanMurzak/Unity-MCP, which should I use?

CoplayDev/unity-mcp at its immutable commit is the default. IvanMurzak/Unity-MCP is selected only when descriptor or doctor evidence shows it satisfies a stated project requirement the default cannot, and that evidence is presented to you.

Can I use an existing local Unity MCP server executable?

Yes, pass --server-executable with an absolute path and --server-sha256 with its hash. Relative paths or hash-mismatched executables are never accepted.

How do I replace an already active Unity MCP adapter?

Use --replace only after comparing capability, quality, cost, performance, security, and limitations between adapters. Rollback is always handled as a separately confirmed transaction.

When should I not invoke the Unity setup workflow?

Do not invoke it for version-only or metadata-only questions about a Unity project. In those cases only the requested project metadata is read and no adapter plan is created.