# Unity Mcp Skills

> Skills and C# command recipes for AI agents controlling the Unity Editor via MCP

- **Type:** MCP server
- **Install:** `agentstack add mcp-batihandev-unity-mcp-skills`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [batihandev](https://agentstack.voostack.com/s/batihandev)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [batihandev](https://github.com/batihandev)
- **Source:** https://github.com/batihandev/unity-mcp-skills

## Install

```sh
agentstack add mcp-batihandev-unity-mcp-skills
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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//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

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

### Codex

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

### Antigravity / Gemini CLI

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

### Symlink alternative (for hacking on the library)

```bash
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

```bash
cd /unity-mcp-skills && git pull
```

## Uninstall

```bash
rm -rf /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//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//`** — per-system guidance (UI, Physics, Animation, …) telling the agent when and how to approach a task.
- **`recipes//`** — 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//`** — 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](https://github.com/obra/superpowers) skill format.

## Credits

Skill library structure and data originally curated by [Besty0728](https://github.com/Besty0728/Unity-Skills).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [batihandev](https://github.com/batihandev)
- **Source:** [batihandev/unity-mcp-skills](https://github.com/batihandev/unity-mcp-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-batihandev-unity-mcp-skills
- Seller: https://agentstack.voostack.com/s/batihandev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.