How do I install the Unity Script skill?

Run npx skillmds@latest add batihandev/unity-script in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Unity Script safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Unity Script?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Unity Script free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Unity Script?

batihandev (@batihandev) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Unity Script by batihandev — Agent Skill

Name: Unity Script
Author: batihandev

File contents

Script Management

Do not use Unity_RunCommand for script operations. The Unity MCP server exposes dedicated tools for every common script operation. Use them directly — they handle Domain Reload coordination and diagnostics natively.

Routing

Operation	Tool	Typical use
Create a new C# script	`Unity_CreateScript`	Writes a new file under `Assets/`; sets up the MonoBehaviour/ScriptableObject/Editor template.
Delete a C# script	`Unity_DeleteScript`	By URI (`unity://path/...`) or by `Assets/...` path.
List script files	`Unity_ListResources`	Commonly filtered to `*.cs` under `Assets/`.
Search inside a script	`Unity_FindInFile`	Regex-level matches with line numbers.
Structured edits	`Unity_ScriptApplyEdits`	Method-level replace / insert / remove. Prefer this over raw text edits.
Syntax + diagnostics check	`Unity_ValidateScript`	Call before and after edits; surfaces compile errors before they trigger a Domain Reload.
Hash for concurrency	`Unity_GetSha`	Compare against your expected hash to detect conflicting edits before writing.

Install-once Editor scripts (screenshot helpers, custom Editor windows, build steps, exporters): check ../tooling/SKILL.md for ready-to-paste templates before writing one from scratch.

Filename must match class name

The .cs filename (without extension) must exactly match the top-level class name. Unity's asset database relies on the 1:1 mapping — mismatches silently break MonoBehaviour attachment and asset references.

When creating a script, pass the scriptName without .cs.
When renaming a class, rename the file in the same operation.

Domain Reload coordination

After any script create / edit / delete, Unity triggers a Domain Reload (compilation + assembly swap). Tools return a compilation block where applicable — check it before issuing the next operation.

If the response reports isCompiling: true, wait for it to settle before the next script edit.
Once compilation completes, call Unity_ValidateScript on the affected file to surface any errors.
Group related edits in a single task where possible — fewer edits = fewer Domain Reloads.

Style guardrails

Meaningful, domain-specific class names.
Group scripts by feature under Assets/Scripts/<Feature>/.
Decide the class role first: MonoBehaviour, ScriptableObject, or plain C# helper.
Prefer explicit dependencies + small responsibilities + event-driven notifications over hidden globals.
Avoid Update-loop polling, repeated GameObject.Find calls, reflection in hot paths, avoidable allocations.
Start from the minimum structure that solves the need — don't dump boilerplate.
After any edit, run Unity_ValidateScript and fix reported errors before marking a task done.

---name: unity-scriptdescription: Use when creating, reading, editing, searching, validating, or deleting C# scripts in a Unity project.---# Script Management**Do not use `Unity_RunCommand` for script operations.** The Unity MCP server exposes dedicated tools for every common script operation. Use them directly — they handle Domain Reload coordination and diagnostics natively.## Routing| Operation | Tool | Typical use ||---|---|---|| Create a new C# script | `Unity_CreateScript` | Writes a new file under `Assets/`; sets up the MonoBehaviour/ScriptableObject/Editor template. || Delete a C# script | `Unity_DeleteScript` | By URI (`unity://path/...`) or by `Assets/...` path. || List script files | `Unity_ListResources` | Commonly filtered to `*.cs` under `Assets/`. || Search inside a script | `Unity_FindInFile` | Regex-level matches with line numbers. || Structured edits | `Unity_ScriptApplyEdits` | Method-level replace / insert / remove. Prefer this over raw text edits. || Syntax + diagnostics check | `Unity_ValidateScript` | Call before and after edits; surfaces compile errors before they trigger a Domain Reload. || Hash for concurrency | `Unity_GetSha` | Compare against your expected hash to detect conflicting edits before writing. |> **Install-once Editor scripts** (screenshot helpers, custom Editor windows, build steps, exporters): check [`../tooling/SKILL.md`](../tooling/SKILL.md) for ready-to-paste templates before writing one from scratch.## Filename must match class nameThe `.cs` filename (without extension) must exactly match the top-level class name. Unity's asset database relies on the 1:1 mapping — mismatches silently break MonoBehaviour attachment and asset references.- When creating a script, pass the `scriptName` **without** `.cs`.- When renaming a class, rename the file in the same operation.## Domain Reload coordinationAfter any script create / edit / delete, Unity triggers a Domain Reload (compilation + assembly swap). Tools return a `compilation` block where applicable — check it before issuing the next operation.1. If the response reports `isCompiling: true`, wait for it to settle before the next script edit.2. Once compilation completes, call `Unity_ValidateScript` on the affected file to surface any errors.3. Group related edits in a single task where possible — fewer edits = fewer Domain Reloads.## Style guardrails- Meaningful, domain-specific class names.- Group scripts by feature under `Assets/Scripts/<Feature>/`.- Decide the class role first: `MonoBehaviour`, `ScriptableObject`, or plain C# helper.- Prefer explicit dependencies + small responsibilities + event-driven notifications over hidden globals.- Avoid `Update`-loop polling, repeated `GameObject.Find` calls, reflection in hot paths, avoidable allocations.- Start from the minimum structure that solves the need — don't dump boilerplate.- After any edit, run `Unity_ValidateScript` and fix reported errors before marking a task done.

Frequently asked questions

Unity Script