unity-skills

Automate Unity Editor operations through a local REST API from chat.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-skills-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-skills
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-skills-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Operating the Unity Editor manually for repetitive or batch tasks—creating GameObjects, editing scripts, configuring materials, running tests—is slow and error-prone. This Skill lets an AI drive the Unity Editor directly through a local REST server, executing hundreds of editor operations with schema validation, permission gating, and dry-run safety checks. ## Core Features & Use Cases - Full Editor Automation: Create and edit scripts, scenes, prefabs, GameObjects, components, materials, lighting, and assets across 53 skill categories and 785 REST skills. - Safe Execution Model: Three operating modes (Approval/Auto/Bypass), dryRun parameter validation, batch execution of up to 50 steps, and transactional rollback via Unity Undo. - Guidance Mode: When the surface profile restricts writes, it switches to teaching manual Editor steps with menu paths and Inspector fields instead of calling REST skills. - Use Case: Ask the AI to create a scene with 20 positioned cubes, each with a configured material and light, then run the EditMode tests—all executed in one batch call with verification via compile status and scene queries. ## Quick Start Ask the AI to create a new C# script named PlayerController and attach it to a GameObject in the current Unity scene.

Frequently Asked Questions about unity-skills

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

FAQPage Schema
How do I automate the Unity Editor from an AI chat?

Install the UnitySkills package in your Unity project, which starts a local REST server on ports 8090-8100. The AI then calls GET /health to detect the server, discovers skills via /skills/recommend, validates parameters with dryRun, and executes editor operations through POST /skill/<name>.

What Unity versions does UnitySkills support?

UnitySkills requires Unity Editor 2022.3 or later, including the Unity 6000.x line. On Unity 6000.4+, GameObjects are located by entityId instead of the legacy instanceId, which is reported as 0.

How do I batch multiple Unity Editor operations in one call?

Use POST /skills/batch with a steps array of up to 50 skill calls. It supports dryRun validation of every step, inter-step references via $ref, and a transactional mode that rolls back all executed steps through Unity Undo if any step fails.

Why does a Unity skill call return MODE_RESTRICTED or SURFACE_EXCLUDED?

MODE_RESTRICTED means the server is in Approval mode and the write skill needs a one-shot user grant via /permission/grant. SURFACE_EXCLUDED means the current surface profile (guide or noSceneAuthoring) hides that write skill; only the user can change the profile in the UnitySkills panel.

Can I run Unity tests and check compilation through the REST API?

Yes. The test module runs Unity Test Runner jobs asynchronously, returning a jobId polled with test_get_result. After script edits, GET /compile/status reports compilation success, errors, and warnings, surviving Domain Reloads.

When should I not use Unity Editor automation?

Skip automation for pure conceptual Unity questions that touch no Editor state, and for simple one-off actions like creating a single cube or changing one color, which are faster done manually. The guidance mode provides manual menu steps for those cases.