unity-project
GitHub提供Unity项目元数据查询与配置能力,涵盖版本、渲染管线、包列表及构建设置。支持只读信息获取及高风险的异步出包操作,辅助开发者管理项目环境与资源。
Trigger Scenarios
Install
npx skills add Besty0728/Unity-Skills --skill unity-project -g -y
SKILL.md
Frontmatter
{
"name": "unity-project",
"description": "Read Unity project metadata and package lists. 读取 Unity 项目元数据与包列表。"
}
Triggers
- Checking Unity version
- Detecting render pipeline
- Listing installed shaders/packages
- 查看 Unity 版本、判断渲染管线、列出已装 shader/包
Project Skills
Project information and configuration.
Operating Mode
build_player 为 RiskLevel=high 的实际出包操作,仅 Bypass 或 Allowlist 放行后可执行;project_add_tag 默认 FullAuto。其余 8 个查询 skill 均为 SemiAuto 只读操作。
Player Settings、Build Settings、Layer 通过本模块只读获取;如需编辑,请使用
editor_execute_menu打开Edit/Project Settings...或File/Build Settings...(菜单本身在 editor 模块为 SemiAuto,可直接执行)。
DO NOT (common hallucinations):
project_savedoes not exist → usescene_save(scene module) oreditor_execute_menumenuPath="File/Save"project_settingsdoes not exist → use specific skills:project_get_render_pipeline,project_get_build_settings, etc.project_set_resolution/project_set_player_settingsdo not exist → Player Settings are read-only viaproject_get_player_settings; to edit, open Project Settings viaeditor_execute_menuwithEdit/Project Settings...project_createdoes not exist → projects are created via Unity Hub, not REST API
Routing:
- For graphics / quality / SRP configuration → use the
graphicsmodule - For Layer/Tag management →
project_add_tag(this module); Layers are read-only viaproject_get_layers(edit viaeditor_execute_menu→Edit/Project Settings...) - For inspecting build settings →
project_get_build_settings; for producing a player →build_player
Skills
project_get_info
Get project information including render pipeline, Unity version, and settings. Parameters: None.
project_get_render_pipeline
Get current render pipeline type and recommended shaders. Parameters: None.
project_list_shaders
List all available shaders in the project. Parameters:
filter(string, optional): Filter by name.limit(int, optional): Max results (default 50).
project_get_build_settings
Get build settings (platform, scenes).
Parameters: None.
Returns: { success, activeBuildTarget, buildTargetGroup, sceneCount, scenes }
build_player
Build a player through BuildPipeline.BuildPlayer and return immediately with an asynchronous Job.
Parameters: outputPath?, target?, scenes?, development=false, overwrite=false. Output must remain inside the project and outside Unity-managed folders.
Returns: {success, status:"accepted", jobId, kind, platform, outputPath, scenes}. Poll /jobs/{id}; the final result contains the BuildReport summary.
project_get_packages
List installed UPM packages.
Parameters: None.
Returns: { success, manifest }
project_get_layers
Get all Layer definitions.
Parameters: None.
Returns: { success, count, layers }
project_get_tags
Get all Tag definitions.
Parameters: None.
Returns: { success, count, tags }
project_add_tag
Add a custom Tag.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| tagName | string | Yes | - | The tag name to add |
Returns: { success, tag }
project_get_player_settings
Get Player Settings.
Parameters: None.
Returns: { success, productName, companyName, bundleVersion, defaultScreenWidth, defaultScreenHeight, fullscreen, apiCompatibility, scriptingBackend }
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
-
25d511e
Current 2026-08-13 09:15
压缩SKILL.md描述字符数,并将路由说明移至Triggers章节
-
14e175d
2026-07-19 18:07
版本升级至2.1.1;重构操作模式说明,明确build_player为高风险需Bypass/Allowlist,其余查询为SemiAuto只读;移除project_get_player_settings技能描述。
- ec9f870 2026-07-05 14:40


