unity-sample
GitHubUnity API连通性测试与基础演示Skill。提供创建几何体、删除对象、查询场景等最小化接口，用于验证REST服务可达性及冒烟测试。仅限测试使用，生产环境请选用gameobject模块。
Trigger Scenarios
Install
npx skills add Besty0728/Unity-Skills --skill unity-sample -g -y
SKILL.md
Frontmatter
{
"name": "unity-sample",
"description": "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 服务是否响应、冒烟测试连通性、或试发第一个调用时使用。"
}
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.
Version History
- ec9f870 Current 2026-07-05 14:40
