# Unity Package

> Unity Package Manager operations. Use when users want to install, remove, or list packages. Triggers: package, UPM, install, dependency, Cinemachine, TextMeshPro, 包管理, Unity安装, Unity依赖.

- Skill: `noah-zll/unity-package` (Agent Skill)
- Install (CLI): `npx skillmds@latest add noah-zll/unity-package`
- Raw SKILL.md: https://api.skillmd.com/api/skills/noah-zll/unity-package/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: noah-zll (https://skillmd.com/u/noah-zll)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/noah-zll/unity-package

---


# Package Skills

Unity Package Manager 操作，支持包的安装、移除和 Cinemachine 自动配置。

## Guardrails

**Mode**: Full-Auto required

**DO NOT** (common hallucinations):
- `package_install_from_git` does not exist → use `package_add` with git URL
- `package_update` does not exist → use `package_add` with the desired version
- `package_get_info` does not exist → use `package_list` to see all installed packages
- Package install/remove may trigger Domain Reload — server temporarily unavailable

**Routing**:
- For Cinemachine/ProBuilder/XR package → `package_add` with correct package name
- For scripting define symbols after package install → use `debug_set_defines`

## Skills

### `package_list`
列出所有已安装的包。
**Parameters:** None.

**Returns:**
```json
{
  "success": true,
  "count": 15,
  "packages": [{"name": "com.unity.cinemachine", "version": "3.1.3", "displayName": "Cinemachine"}]
}
```

### `package_check`
检查包是否已安装。
**Parameters:**
- `packageId` (string, required): 包 ID，如 `com.unity.cinemachine`

**Returns:**
```json
{"packageId": "com.unity.cinemachine", "installed": true, "version": "3.1.3"}
```

### `package_install`
安装指定包。
**Parameters:**
- `packageId` (string, required): 包 ID
- `version` (string, optional): 版本号

### `package_remove`
移除已安装的包。
**Parameters:**
- `packageId` (string, required): 包 ID

### `package_refresh`
刷新已安装包列表缓存。
**Parameters:** None.

### `package_install_cinemachine`
安装 Cinemachine，自动处理依赖。
**Parameters:**
- `version` (int, optional): 2 或 3，默认 3。CM3 自动安装 Splines 依赖。

**Notes:**
- UnitySkills startup auto-install uses CM2 on Unity 2022 and CM3 on Unity 6.
- If you explicitly install CM3 in Unity 2022, prefer stable `3.0.1+ / 3.1.x`. Early `3.0.0-pre.1/.2` previews used different core camera APIs and are outside the current support baseline.

### `package_get_cinemachine_status`
获取 Cinemachine 安装状态。
**Parameters:** None.

**Returns:**
```json
{
  "cinemachine": {"installed": true, "version": "3.1.3", "isVersion3": true},
  "splines": {"installed": true, "version": "2.8.0"}
}
```

### `package_install_splines`
Install Unity Splines package. Auto-detects correct version for Unity 6 vs Unity 2022.

**Parameters:** None.

**Returns:**
```json
{
  "success": true,
  "message": "Installing Splines 2.8.0...",
  "async": true
}
```

### `package_search`
Search for packages in the Unity Registry.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| query | string | Yes | - | 搜索关键词，匹配包名或显示名称 |

**Returns:**
```json
{
  "success": true,
  "query": "cinemachine",
  "count": 1,
  "packages": [{"name": "com.unity.cinemachine", "version": "3.1.3", "displayName": "Cinemachine"}]
}
```

### `package_get_dependencies`
Get dependency list for an installed package.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| packageId | string | Yes | - | 包 ID，如 `com.unity.cinemachine` |

**Returns:**
```json
{
  "success": true,
  "packageId": "com.unity.cinemachine",
  "version": "3.1.3",
  "dependencyCount": 1,
  "dependencies": [{"name": "com.unity.splines", "version": "2.8.0"}]
}
```

### `package_get_versions`
Get all available versions for a package.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| packageId | string | Yes | - | 包 ID，如 `com.unity.cinemachine` |

**Returns:**
```json
{
  "success": true,
  "packageId": "com.unity.cinemachine",
  "currentVersion": "3.1.3",
  "compatibleVersion": "3.1.3",
  "latestVersion": "3.1.3",
  "allVersions": ["2.10.0", "3.0.0", "3.1.3"]
}
```