unity-sample

Tests Unity REST API connectivity with sample scene query and primitive creation calls.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying that a Unity skills REST server is reachable and responding correctly is a necessary first step before running real scene automation, and this module provides lightweight demo calls for that smoke-testing purpose. ## Core Features & Use Cases - Connectivity Smoke Tests: Run simple query skills like get_scene_info and find_objects_by_name to confirm the REST server is reachable. - Primitive Authoring Demos: Create cubes and spheres or adjust object position, rotation, and scale to validate write-path behavior. - Guardrail Demonstration: Shows the three-tier operating mode (Approval, Auto, Bypass) and surface profile exclusions, with delete_object restricted to Bypass or Allowlist. - Use Case: After setting up a Unity skills server, call get_scene_info to confirm the connection works before routing real work to the gameobject module. ## Quick Start Ask the assistant to run the sample get_scene_info skill to verify the Unity REST server connection is working.

Frequently Asked Questions about unity-sample

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

FAQPage Schema
How do I test Unity REST server connectivity?

Call a query skill such as get_scene_info or find_objects_by_name, which run directly under the default Approval mode. A successful response confirms the server is reachable before you attempt any write operations.

What is the difference between the sample module and the gameobject module?

The sample module contains basic demo skills for connectivity testing, while the gameobject module provides the full production GameObject operations. For real scene authoring work, route to the gameobject module instead of sample_create-style calls.

Why does delete_object return MODE_FORBIDDEN?

delete_object is classified as SkillOperation.Delete and is auto-forbidden in this module. It only runs under Bypass mode or through a user-managed Allowlist entry; the grant flow returns MODE_FORBIDDEN otherwise.

What parameters does create_cube require?

create_cube accepts x, y, z coordinates and a name parameter. Exact signatures, defaults, and return values should be fetched from GET /skills/schema or unity_skills.get_skill_schema() rather than guessed from documentation.

When should I not use the sample skills?

Do not use sample skills for production scene work, since they are simplified test and demo calls. Use the gameobject module for actual GameObject operations and the Python helper unity_skills.health() for server health checks.