unity-skills

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

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-skills-dylan8865
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-skills
Source: https://github.com/Dylan8865/FinalYearProject/tree/main/GameDev/Tester/.agents/skills/unity-skills
Command: npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-skills-dylan8865

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 and lighting, running tests—is slow and error-prone. This Skill lets an AI agent drive the Unity Editor directly through a local REST server, covering roughly 750 operations across dozens of modules. ## Core Features & Use Cases - Editor Automation via REST: Create and edit scripts, GameObjects, components, prefabs, scenes, materials, lights, UI, terrain, and more through the UnitySkills REST server, with batch variants for multi-object operations. - Permission Modes & Safety Gates: 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. - Advisory Design Modules & API References: 19 documentation-only modules (architecture, patterns, Netcode, DOTween, UniTask, Addressables, ShaderGraph, YAML editing) plus topic-organized Unity Manual references to ground code generation in real APIs. - Use Case: Ask the agent to build a scene with lighting and a camera rig, batch-rename 50 GameObjects, then run EditMode tests and poll the async job result—all without touching the Editor UI. ## Quick Start Ask the agent to check the UnitySkills server health and then create a new C# script 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 agent?▼

Run the UnitySkills REST server inside the Unity Editor, then call its endpoints such as GET /health and module skills like gameobject_create or script_update. The agent can also use the unity_skills.py helper to query the schema and invoke skills.

What Unity version does UnitySkills require?▼

UnitySkills targets Unity 2022.3 or newer, with notes for Unity 6000.4+ where instanceId is unreliable and entityId should be used to locate objects. Set version routing with unity_skills.set_unity_version when working across editor versions.

Why does a Unity skill call return MODE_RESTRICTED or MODE_FORBIDDEN?▼

MODE_RESTRICTED means the server is in Approval mode and the skill needs a single-shot grant via POST /permission/grant after user consent. MODE_FORBIDDEN means the skill is auto-classified as high-risk (delete, play mode, domain reload) and only runs under Bypass mode or an explicit Allowlist entry.

How do I run Unity tests through the REST API?▼

Test skills are asynchronous: calling a test_* skill returns a jobId instead of a final result. Poll test_get_result with that jobId until the job completes to retrieve pass/fail status and logs.

Should I call single-object skills in a loop for many GameObjects?▼

No. The skill enforces a batch-first rule: whenever a task touches two or more objects, use the *_batch variant of the skill. Looping single-object calls wastes round-trips and doubles grant prompts under Approval mode.

Can the AI change the UnitySkills operating mode from chat?▼

No. Operating mode is a server-side setting configured in Window > UnitySkills > Server and persisted per machine. The agent must read GET /health to learn the current mode and adapt its grant and confirmation behavior accordingly.