Agent Skills › Besty0728/Unity-Skills › unity-sample

unity-sample

GitHub

Unity API连通性测试与演示技能集，提供基础API调用示例。用于验证REST服务可达性、冒烟测试及首次调用尝试。包含创建/删除游戏对象、查询场景信息等基础操作，仅供测试和演示使用，禁止生产环境。

SkillsForUnity/unity-skills~/skills/sample/SKILL.md Besty0728/Unity-Skills

Trigger Scenarios

测试 REST 服务可达性冒烟测试连通性试发第一个调用

Install

npx skills add Besty0728/Unity-Skills --skill unity-sample -g -y

More Options

Non-standard path

npx skills add https://github.com/Besty0728/Unity-Skills/tree/main/SkillsForUnity/unity-skills~/skills/sample -g -y

Use without installing

npx skills use Besty0728/Unity-Skills@unity-sample

指定 Agent (Claude Code)

npx skills add Besty0728/Unity-Skills --skill unity-sample -a claude-code -g -y

安装 repo 全部 skill

npx skills add Besty0728/Unity-Skills --all -g -y

预览 repo 内 skill

npx skills add Besty0728/Unity-Skills --list

SKILL.md

Frontmatter

{
    "name": "unity-sample",
    "description": "Sample and demo skills for API connectivity testing"
}

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

Testing REST server reachability
Smoke-testing connectivity
Trying a first call
测试 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 — on MODE_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 returns MODE_FORBIDDEN.

DO NOT (common hallucinations):

Sample skills are basic test/demo skills — do not use them for production work
sample_create is a simplified version of gameobject_create — prefer the full gameobject module
sample_hello / sample_ping are connectivity test skills only

Routing:

For actual GameObject operations → use gameobject module
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

5ee8388 Current 2026-08-17 04:12
精简根SKILL.md体积至6.2KB，新增指南模式文档与手动-自动边界说明，补充兼容性字段，版本锚点更新至2.6.0。
25d511e 2026-08-13 09:15
压缩描述至指定字符数，并将路由说明移至Triggers部分
ec9f870 2026-07-05 14:40

Metadata

Files: 0
Version: 5ee8388
Hash: e8aeeab3
Indexed: 2026-07-05 14:40

unity-sample

unity-sample

Trigger Scenarios

Install

SKILL.md

Triggers

Sample Skills

Guardrails

Skills

create_cube

create_sphere

delete_object

find_objects_by_name

set_object_position

set_object_rotation

set_object_scale

get_scene_info

Exact Signatures

Version History

Same Skill Collection

Metadata

文库

`find_objects_by_name`

`set_object_position`

`set_object_rotation`

`set_object_scale`

`get_scene_info`