Unity Sample
Testing & Qualityunity-sampleUnity Sample is an Agent Skill for testing & quality published in the Besty0728/Unity-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Sample and demo skills for API connectivity testing — minimal echo/ping-style calls to verify the REST server is reachable. Use when testing whether the UnitySkills REST server responds, smoke-testing connectivity, or trying a first call, even if the user just says "测试连接" or "通不通". 用于 API 连通性测试的示例/演示 skill(最小的 echo/ping 式调用,验证 REST 服务可达);当用户要测试 UnitySkills REST 服务是否响应、冒烟测试连通性、或试发第一个调用时使用。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Besty0728/Unity-Skills/blob/HEAD/SkillsForUnity/unity-skills~/skills/sample/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/unity-sample, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Sample Skills
Basic examples for testing the API.
Guardrails
Operating Mode (v1.9 three-tier):
- Approval (default): query skills (
get_scene_info,find_objects_by_name) run directly. Creators/mutators (create_cube,create_sphere,set_object_position,set_object_rotation,set_object_scale) are FullAuto — onMODE_RESTRICTED, run the grant protocol. - Auto / Bypass: SemiAuto and FullAuto run directly.
- Auto-forbidden in this module:
delete_object(SkillOperation.Delete). It is reachable only under Bypass or via a user-managed Allowlist entry; the grant flow returnsMODE_FORBIDDEN.
DO NOT (common hallucinations):
- Sample skills are basic test/demo skills — do not use them for production work
sample_createis a simplified version ofgameobject_create— prefer the full gameobject modulesample_hello/sample_pingare connectivity test skills only
Routing:
- For actual GameObject operations → use
gameobjectmodule - For server health check → use Python helper's
unity_skills.health()
Skills
create_cube
Create a cube primitive.
Parameters: x, y, z, name
create_sphere
Create a sphere primitive.
Parameters: x, y, z, name
delete_object
Delete object by name.
Parameters: objectName
find_objects_by_name
Find objects containing string.
Parameters: nameContains (name is also accepted as a compatibility alias)
set_object_position
Set object position.
Parameters: objectName, x, y, z
set_object_rotation
Set object rotation.
Parameters: objectName, x, y, z
set_object_scale
Set object scale.
Parameters: objectName, x, y, z
get_scene_info
Get current scene information. Parameters: None.
Exact Signatures
Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.