unity-skills

Automate Unity Editor operations through a local REST API across 80 modules.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-skills-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-skills
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-skills-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Manually performing repetitive Unity Editor tasks—creating GameObjects, editing scripts, building scenes, configuring materials, running tests—is slow and error-prone. This Skill lets an AI drive the Unity Editor directly through the UnitySkills local REST server, executing hundreds of editor operations from chat with permission gating and validation. ## Core Features & Use Cases - Full Editor Automation: Create and edit scripts, GameObjects, scenes, prefabs, materials, lighting, and assets via 785 REST skills grouped into 53 categories and 80 documented modules. - Safe Execution Model: Three operating modes (Approval/Auto/Bypass), single-shot grants, an Allowlist, dryRun validation, batch execution of up to 50 steps, and transactional rollback via Unity Undo. - Guidance Mode: When the surface profile hides write skills, the Skill switches to instructor mode, giving precise manual Editor steps (menu paths, Inspector fields, shortcuts) instead of calling REST. - Use Case: Ask the AI to create a URP scene with a camera, directional light, and a prefab-spawned player, then run EditMode tests—all executed through batched REST calls with compilation feedback verified via the events endpoint. ## Quick Start Ask the AI to check the UnitySkills server health and then create a cube in the current Unity scene using the unity-skills REST API.

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 operations through POST /skill/<name>.

What Unity versions does UnitySkills support?

UnitySkills supports Unity Editor 2022.3 and 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 create or edit Unity scripts through the REST API?

Use the script module skills such as script create, read, and update operations. After any script write, wait out the Domain Reload, then call GET /compile/status to confirm compilation succeeded and read exact error lines if it failed.

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 surfaceProfile (guide or noSceneAuthoring) hides that write skill; only the user can change the profile in the UnitySkills panel.

Can I batch multiple Unity Editor operations in one request?

Yes, POST /skills/batch executes up to 50 steps in one HTTP call with fail-fast or continueOnError semantics. It supports $ref references between steps, a dryRun mode that validates every step, and a transactional mode that rolls back executed steps via Unity Undo on failure.

When should I use guidance mode instead of Unity Editor automation?

Use guidance mode when the user asks how to do something manually, or when the task is a simple one-off action finishable in three or fewer clicks, like creating one cube or changing one color. Automation is better for traversal, search, batch edits, and exact numeric values.