unity-sample

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying that a Unity skills REST server is reachable and responding correctly is a common first step before running real scene automation, and this module provides lightweight demo calls for exactly 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 and responding. - Primitive Demo Operations: Create cubes and spheres or adjust object position, rotation, and scale to validate the full request pipeline end to end. - Use Case: After setting up a Unity skills server, call get_scene_info to confirm connectivity, then create_cube to verify that mutating operations and the approval/grant flow behave as expected before switching to the full gameobject module. ## Quick Start Ask the assistant to run the sample get_scene_info skill to confirm the Unity REST server is reachable and return the current scene information.

Frequently Asked Questions about unity-sample

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

FAQPage Schema
How do I test if my Unity skills REST server is reachable?

Call a query skill like get_scene_info or find_objects_by_name, which run directly without approval. A successful response confirms the server is reachable and the request pipeline works.

What is the difference between sample_create and gameobject_create?

sample_create is a simplified demo version intended only for connectivity testing. For real GameObject authoring work, use the full gameobject module, which provides the complete feature set.

Why does delete_object return MODE_FORBIDDEN?

delete_object is auto-forbidden in this module and only runs under Bypass mode or through a user-managed Allowlist entry. Under restricted modes the grant flow returns MODE_FORBIDDEN by design.

Can I use sample skills for production Unity scene work?

No, sample skills are basic test and demo skills not intended for production. Route actual GameObject operations to the gameobject module and use the Python helper's unity_skills.health() for server health checks.

Where do I find exact parameter definitions for these skills?

Exact names, parameters, defaults, and returns come from GET /skills/schema or unity_skills.get_skill_schema(), not from the SKILL.md file. Fetch the schema before calling skills with guessed parameters.