Agent skill

Unity Initial Setup

by IvanMurzak in IvanMurzak/Unity-MCP

Provides an initial setup for AI Skills, unity-mcp-cli command line tool installation and everything else that is helpful to set up at the start of the project.

Apache-2.0Auto-check passedGame Development

Install Unity Initial Setup

skills CLI
$ npx skills add IvanMurzak/Unity-MCP --skill unity-initial-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install IvanMurzak/Unity-MCP unity-initial-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/IvanMurzak/Unity-MCP.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Unity-MCP-Plugin/.claude/skills/unity-initial-setup .claude/skills/unity-initial-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
unity-initial-setup
GitHub stars
4.4k
Token cost
~855 tokens
SKILL.md length
334 words
Files
1
Skills in repo
80
Repo updated
First seen
Licence
Apache-2.0

At a glance

Provides an initial setup for AI Skills, unity-mcp-cli command line tool installation and everything else that is helpful to set up at the start of the project.

  • Works in 5 steps: Install the Unity-MCP Plugin → Configure MCP Tools → Set Up MCP for Your AI Agent → …
  • Tasks that involve Game development
  • SKILL.md covers Prerequisites, Install unity-mcp-cli Globally, Quick Start — Full Project Setup and Common Commands Reference, plus 1 more section
  • Calls npm, winget and node

What it does

Unity Initial Setup is an agent skill from IvanMurzak/Unity-MCP. Provides an initial setup for AI Skills, unity-mcp-cli command line tool installation and everything else that is helpful to set up at the start of the project. Essential packages, and basic configurations.

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development, covering Game development and MCP servers. It works with Model Context Protocol, Node.js and Unity. The repository describes itself as: AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C method may be turned into a… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Game development
  • Tasks that involve MCP servers

Example prompts

  • “Use the unity-initial-setup skill to provide an initial setup for AI Skills, unity-mcp-cli command line tool installation and everything else that…”
  • “/unity-initial-setup”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Install the Unity-MCP Plugin
  2. Configure MCP Tools
  3. Set Up MCP for Your AI Agent
  4. Generate AI Skills
  5. Open Unity with MCP Connection

What it can do on your machine

Read from SKILL.md and the folder at commit 4c8056f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • winget
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • nodejs.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unity Initial Setup loads about 855 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 334 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~855

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from IvanMurzak/Unity-MCP at commit 4c8056f, republished under its Apache-2.0 licence (© IvanMurzak). 334 words, ~855 tokens.

Download SKILL.mdSave it as .claude/skills/unity-initial-setup/SKILL.md (or your agent's skills folder).
name
unity-initial-setup
description
Provides an initial setup for AI Skills, `unity-mcp-cli` command line tool installation and everything else that is helpful to set up at the start of the project. Essential packages, and basic configurations.

AI Game Developer — Initial Setup

This guide walks through installing the unity-mcp-cli command-line tool and using it to set up a Unity project with AI Skills and MCP integration.


Prerequisites

Install Node.js

unity-mcp-cli requires Node.js ^20.19.0 || >=22.12.0 (Node 21.x is not supported). If you don't have Node.js installed:

Download the installer from https://nodejs.org/ and run it, or use a package manager:

winget install OpenJS.NodeJS.LTS

After installation, verify both node and npm are available:

node --version
npm --version

Install unity-mcp-cli Globally

Install the CLI globally so the unity-mcp-cli command is available system-wide:

bash
npm install -g unity-mcp-cli

Verify installation:

bash
unity-mcp-cli --version

Alternative: Run any command without installing globally using npx:

bash
npx unity-mcp-cli --help

Quick Start — Full Project Setup

1. Install the Unity-MCP Plugin

Add the plugin to an existing Unity project:

bash
unity-mcp-cli install-plugin /path/to/unity/project
2. Configure MCP Tools

Enable all tools, prompts, and resources:

bash
unity-mcp-cli configure /path/to/unity/project \
  --enable-all-tools \
  --enable-all-prompts \
  --enable-all-resources
3. Set Up MCP for Your AI Agent

Configure MCP integration for your AI agent (e.g., Claude Code, Cursor, Copilot):

bash
unity-mcp-cli setup-mcp claude-code /path/to/unity/project

List all supported agents:

bash
unity-mcp-cli setup-mcp --list
4. Generate AI Skills

Generate skill files for your AI agent (requires Unity Editor to be running with the plugin):

bash
unity-mcp-cli setup-skills claude-code /path/to/unity/project
5. Open Unity with MCP Connection
bash
unity-mcp-cli open /path/to/unity/project

Common Commands Reference

CommandDescription
unity-mcp-cli install-plugin <path>Install Unity-MCP plugin into a project
unity-mcp-cli remove-plugin <path>Remove Unity-MCP plugin from a project
unity-mcp-cli configure <path> --listList current MCP configuration
unity-mcp-cli setup-mcp <agent> <path>Write MCP config for an AI agent
unity-mcp-cli setup-skills <agent> <path>Generate skill files for an AI agent
unity-mcp-cli create-project <path>Create a new Unity project
unity-mcp-cli install-unity <version>Install a Unity Editor version
unity-mcp-cli open <path>Open a Unity project in the Editor
unity-mcp-cli run-tool <tool> <path>Execute an MCP tool via HTTP API

Add --verbose to any command for detailed diagnostic output.


Troubleshooting

  • npm not found: Node.js is not installed or not in your PATH. Reinstall Node.js and restart your terminal.
  • Plugin not appearing in Unity: After install-plugin, open the project in Unity Editor. The package manager resolves dependencies on project open.
  • Skills generation fails: Ensure Unity Editor is running with the MCP plugin installed and connected before running setup-skills.

© IvanMurzak, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in Unity-MCP-Plugin/.claude/skills/unity-initial-setup of IvanMurzak/Unity-MCP.

Open the folder on GitHubat commit 4c8056f

Compare with similar skills

Unity Initial Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unity Initial Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unity Initial Setup this skillIvanMurzak/Unity-MCP4.4k—~855Automated safety check: PassApache-2.0
Unity PluginTomLeeLive/openclaw-unity-plugin106—~5.1kAutomated safety check: PassApache-2.0
Unreal Blueprint Authoringflopperam/unreal-engine-mcp1.1k—~1.6kAutomated safety check: PassNone
MCP DriverRandallLiuXin/GodotMaker5491 repos~1.1kAutomated safety check: PassCustom licence
Roblox Gamebrockmartin/roblox-game-skill197—~1.3kAutomated safety check: PassNone
Unreal Engine MCPEpicGames/unreal-engine-skills-for-claude-code-plugin325—~1.8kAutomated safety check: PassMIT

Similar skills

  • Unity Plugin

    TomLeeLive/openclaw-unity-plugin

    Control Unity Editor via OpenClaw Unity Plugin. An agent skill from TomLeeLive/openclaw-unity-plugin.

    106 GitHub stars~5.1k tokensUpdated 29 days ago
    Game DevelopmentAuto-check passed
  • Unreal Blueprint Authoring

    flopperam/unreal-engine-mcp

    Walks an agent through creating and editing Unreal Engine Blueprints with the Flopperam MCP's bp_* tools, from inspection to commit and verification.

    1.1k GitHub stars~1.6k tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed
  • MCP Driver

    RandallLiuXin/GodotMaker

    Runtime debugging and live project inspection via godot-mcp.

    549 GitHub starsUsed in 1 repo~1.1k tokens
    Game DevelopmentAuto-check passed
  • Roblox Game

    brockmartin/roblox-game-skill

    Expert Roblox game development companion — Luau, Roblox Studio, MCP integration, simulator, tycoon, obby, RPG, horror, battle royale, game design, security, performance.

    197 GitHub stars~1.3k tokensUpdated 7 mo ago
    Game DevelopmentAuto-check passed
  • Unreal Engine MCP

    EpicGames/unreal-engine-skills-for-claude-code-plugin

    Drives a live Unreal Editor through the unreal-mcp server: spawn actors, edit Blueprints, materials and sequences, change properties and trigger Live Coding.

    325 GitHub stars~1.8k tokensUpdated 20 days ago
    Game DevelopmentAuto-check passed
  • Unreal Scene Building

    flopperam/unreal-engine-mcp

    Guides scene and world building in Unreal Engine through the Flopperam MCP: placing actors, sculpting landscapes, scattering foliage, editing materials and verifying the level.

    1.1k GitHub stars~1.4k tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed

More from IvanMurzak/Unity-MCP

All 80 skills in this repo
  • Assets Shader List All

    IvanMurzak/Unity-MCP

    List all shaders available in the project assets and packages, sorted by name.

    4.4k GitHub stars~435 tokensUpdated 3 days ago
    Auto-check passed
  • Gameobject Component List All

    IvanMurzak/Unity-MCP

    List the fully-qualified C type names of every concrete UnityEngine.Component subclass available in the project.

    4.4k GitHub stars~846 tokensUpdated 3 days ago
    Auto-check passed
  • Package Add

    IvanMurzak/Unity-MCP

    Install a Unity package from the registry, a Git URL, or a local path.

    4.4k GitHub stars~665 tokensUpdated 3 days ago
    Auto-check passed
  • Package Remove

    IvanMurzak/Unity-MCP

    Uninstall a UPM package from the Unity project. An agent skill from IvanMurzak/Unity-MCP.

    4.4k GitHub stars~602 tokensUpdated 3 days ago
    Auto-check passed
  • Unity Version Split

    IvanMurzak/Unity-MCP

    Split a C file into Unity 6.5+ and pre-Unity 6.5 variants. An agent skill from IvanMurzak/Unity-MCP.

    4.4k GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Assets Copy

    IvanMurzak/Unity-MCP

    Copy assets at given paths and store them at new paths. An agent skill from IvanMurzak/Unity-MCP.

    4.4k GitHub stars~1k tokensUpdated 3 days ago
    Auto-check passed

Questions about Unity Initial Setup

What does Unity Initial Setup do?

Provides an initial setup for AI Skills, unity-mcp-cli command line tool installation and everything else that is helpful to set up at the start of the project. Unity Initial Setup is an agent skill from IvanMurzak/Unity-MCP. Provides an initial setup for AI Skills, unity-mcp-cli command line tool installation and everything else that is helpful to set up at the start of the project.

When should I use Unity Initial Setup?

Unity Initial Setup fits situations like: tasks that involve Game development; tasks that involve MCP servers.

How do I install Unity Initial Setup in Claude Code?

Run `npx skills add IvanMurzak/Unity-MCP --skill unity-initial-setup -a claude-code`. Or copy the skill folder (Unity-MCP-Plugin/.claude/skills/unity-initial-setup in IvanMurzak/Unity-MCP) into .claude/skills/unity-initial-setup in your project. Claude Code loads it when a task matches its description.

How do I install Unity Initial Setup in Codex?

Run `npx skills add IvanMurzak/Unity-MCP --skill unity-initial-setup -a codex`. Or copy the skill folder (Unity-MCP-Plugin/.claude/skills/unity-initial-setup in IvanMurzak/Unity-MCP) into .agents/skills/unity-initial-setup in your project. Codex loads it when a task matches its description.

Can I use Unity Initial Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add IvanMurzak/Unity-MCP --skill unity-initial-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unity-initial-setup, .gemini/skills/unity-initial-setup, .github/skills/unity-initial-setup and .opencode/skills/unity-initial-setup in your project.

What does Unity Initial Setup need to run?

Going by SKILL.md and its folder, Unity Initial Setup needs the command-line tools its instructions call (npm, winget and node). Our summary lists: Node.js.

Does Unity Initial Setup access the network?

SKILL.md names 1 domain. As links in the text: nodejs.org. This is read from the text; nothing was executed.

Is Unity Initial Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Unity Initial Setup use?

Unity Initial Setup is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unity Initial Setup use?

About 855 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Unity Initial Setup?

Skills that share tags, products or a category with Unity Initial Setup: Unity Plugin (TomLeeLive/openclaw-unity-plugin, 106 stars), Unreal Blueprint Authoring (flopperam/unreal-engine-mcp, 1.1k stars), MCP Driver (RandallLiuXin/GodotMaker, 549 stars) and Roblox Game (brockmartin/roblox-game-skill, 197 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unity Initial Setup?

IvanMurzak (a GitHub user) maintains it in IvanMurzak/Unity-MCP, which has 4,392 GitHub stars. The repository holds 80 skills in this directory. The repository was last updated on October 4, 2026.

Source: IvanMurzak/Unity-MCP on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.