Unity MCP Skills Library

A documentation-only skill pack for AI agents working inside Unity via the official Unity MCP. No C# plugin, no REST server, no Python client — just markdown that teaches your agent how Unity actually works.

It contains skills (per-system guardrails and routing) and recipes (ready-to-run C# IRunCommand templates) so the agent can act predictably without wrecking your scene.

Work in progress. Things may be incomplete or rough around the edges — use with that expectation.

Requires:

  • Unity's com.unity.ai.assistant package with its Unity MCP Server enabled in Project Settings → AI → Unity MCP Server — the hard dependency that provides Unity_RunCommand and the IRunCommand contract every recipe targets. Nothing in this pack runs without it.
  • Unity 6000+ (Unity 6). Recipes use FindFirstObjectByType / FindObjectsByType; older versions are not supported.
  • Per-domain package baselines listed in each skills/<domain>/SKILL.md ## Requirements block. Domain skills tell the agent how to install missing ones via Unity_PackageManager_ExecuteAction.

Install

Clone this repo as a single folder inside your agent's skills directory. The whole repo is the install unit — domain skills depend on shared helpers (recipes/_shared/), tool routing (mcp-tools.md), and fallback docs (references/) that ship together.

Claude Code

git clone https://github.com/batihandev/unity-mcp-skills.git ~/.claude/skills/unity-mcp-skills

Codex

git clone https://github.com/batihandev/unity-mcp-skills.git ~/.codex/skills/unity-mcp-skills

Antigravity / Gemini CLI

git clone https://github.com/batihandev/unity-mcp-skills.git ~/.gemini/antigravity/skills/unity-mcp-skills

Symlink alternative (for hacking on the library)

git clone https://github.com/batihandev/unity-mcp-skills.git ~/src/unity-mcp-skills
ln -s ~/src/unity-mcp-skills ~/.claude/skills/unity-mcp-skills

Update

cd <your-skills-dir>/unity-mcp-skills && git pull

Uninstall

rm -rf <your-skills-dir>/unity-mcp-skills

Prerequisites

  • A Unity MCP-compatible server running in your Unity Editor; the Editor must be open during use.
  • An AI agent that can read local files and execute MCP tools (e.g. Unity_RunCommand).

How discovery works

Only the top-level SKILL.md is registered with your agent — under the name unity-mcp-skills. That skill routes to domain-specific skills under skills/<domain>/SKILL.md internally. You will not see unity-scene, unity-physics, etc. as separate skills in your agent — they are loaded on demand by the library.

What's in here

  • SKILL.md — the discoverable entry point; routes to the right domain.
  • skills/<domain>/ — per-system guidance (UI, Physics, Animation, …) telling the agent when and how to approach a task.
  • recipes/<domain>/ — C# IRunCommand templates the agent fills in and runs; designed to support Editor Undo/Redo.
  • recipes/_shared/ — cross-domain C# helpers embedded by recipes.
  • tooling/<domain>/ — install-once Editor script templates installed via Unity_CreateScript; persistent project tools (menu items, custom windows), no compile/run gate.
  • references/ — offline reference dumps used as a tertiary fallback when skills and recipes lack detail.
  • mcp-tools.md — routing matrix for native MCP tools vs Unity_RunCommand.

Format

Skills follow the superpowers skill format.

Credits

Skill library structure and data originally curated by Besty0728.