unity-skills

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

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-skills-du-qwq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-skills
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-skills-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Operating the Unity Editor manually for repetitive tasks like creating GameObjects, editing scripts, building scenes, and batch-modifying assets is slow and error-prone. This Skill lets you drive hundreds of Unity Editor operations directly from chat through a local REST server, with built-in permission modes and safety gates. ## Core Features & Use Cases - Editor Automation via REST API: Create and edit scripts, GameObjects, components, prefabs, scenes, materials, lights, and UI across roughly 750 skills in 51 modules, with batch variants for multi-object operations. - Permission & Safety Model: Three operating modes (Approval, Auto, Bypass) with single-shot grants, a user-managed Allowlist, and confirmation tokens for high-risk actions like deletes and domain reloads. - Design Guidance & API Reference: 19 advisory modules covering architecture, patterns, async, Netcode, DOTween, UniTask, Addressables, YooAsset, and ShaderGraph, plus topic-organized official Unity documentation references. - Use Case: Ask the assistant to create a player character prefab with a Rigidbody, collider, and movement script, then run EditMode tests — all executed against your open Unity project without touching the Editor UI. ## Quick Start Ask the assistant to create a new C# script and attach it to a GameObject in the currently open Unity project.

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 assistant?

Install the UnitySkills server in your Unity project, then use this Skill to call its local REST API. You can create scripts, GameObjects, prefabs, and scenes, edit materials and lighting, and run tests directly from chat commands.

What Unity version does UnitySkills support?

UnitySkills targets Unity 2022.3 and later, including Unity 6000.x. On Unity 6000.4+, GameObjects are located by entityId instead of the legacy instanceId, and the Skill handles this locator priority automatically.

How do Approval, Auto, and Bypass modes work in UnitySkills?

The mode is set server-side in Window > UnitySkills > Server and read via GET /health. Approval requires a single-shot grant per call, Auto executes with audit logging, and Bypass runs everything including high-risk skills. The mode cannot be switched from chat.

Can I batch-edit multiple Unity objects at once?

Yes, the Skill enforces a batch-first rule: whenever a task touches two or more objects, use the *_batch skill variants instead of looping single-object calls. This reduces round-trips and avoids repeated approval grants under Approval mode.

Why does a Unity skill call return MODE_RESTRICTED or MODE_FORBIDDEN?

MODE_RESTRICTED means the server is in Approval mode and the call needs a one-time grant via /permission/grant. MODE_FORBIDDEN means the skill is auto-classified as high-risk (delete, play mode, domain reload) and requires Bypass mode or an Allowlist entry.

Does UnitySkills support running Unity tests?

Yes, test_* skills run the Unity Test Runner asynchronously. They return a jobId that you poll with test_get_result until the EditMode or PlayMode test run completes.