Skip to content
Back to search

Unity-Skills

AI automation skills specifically designed for Unity

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Besty0728/Unity-Skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Besty0728/Unity-Skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/besty0728--unity-skills/badge.svg)](/listings/besty0728--unity-skills)

HTML

<a href="/listings/besty0728--unity-skills"><img src="/api/listings/besty0728--unity-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This project has been deeply optimized for the following environments (tools not listed are not necessarily unsupported — they just lack a quick installer; use ***Custom Installation*** instead. Per-tool skill directories are listed in the Manual Installation section below):

| AI Terminal | Support Status | Notes | | :--- | :---: | :--- | | **Antigravity** | ✅ Supported | Open Agent Skills standard; shares `.agents/skills/` with Codex in workspace mode | | **Claude Code** | ✅ Supported | Intelligent Skill intent recognition, supports complex multi-step automation | | **Codex** | ✅ Supported | Supports `$skill` explicit invocation and implicit intent recognition | | **Cursor** | ✅ Supported | Auto-discovers skill directories; supports `/skill-name` explicit invocation | | **Kimi Code** | ✅ Supported | Native skill directory discovery; supports `/skill:unity-skills` explicit invocation | | **OpenCode** | ✅ Supported | Native workspace and global skill directory discovery |

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 365 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # 🎮 UnitySkills
  2. <p align="center">
  3. <img src="docs/images/Unity-Skills-H.png" alt="Unity-Skills" width="800">
  4. </p>
  5. <p align="center">
  6. <img src="https://img.shields.io/badge/Unity-2022.3%2B-black?style=for-the-badge&logo=unity" alt="Unity">
  7. <img src="https://img.shields.io/badge/Skills-873-green?style=for-the-badge" alt="Skills">
  8. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-orange?style=for-the-badge" alt="License"></a>
  9. <a href="README_CN.md"><img src="https://img.shields.io/badge/README-中文-blue?style=for-the-badge" alt="中文"></a>
  10. </p>
  11. <p align="center">
  12. <b>REST API-based AI-driven Unity Editor Automation Engine</b><br>
  13. <i>Let AI control Unity scenes directly through Skills</i>
  14. </p>
  15. <p align="center">
  16. 🎉 We are now indexed by <b>DeepWiki</b>!<br>
  17. Got questions? Check out the AI-generated docs → <a href="https://deepwiki.com/Besty0728/Unity-Skills"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
  18. </p>
  19. > The current official maintenance baseline is **Unity 2022.3+**. Some Unity 2021 compatibility logic may still remain in the codebase, but future feature work, regression testing, and adaptation will focus on **2022.3+ / Unity 6**.
  20. ## 💖 Sponsors
  21. <!-- sponsors:start -->
  22. <div align="center">
  23. <table>
  24. <tr>
  25. <th>Sponsor</th>
  26. <th>Contribution</th>
  27. </tr>
  28. <tr>
  29. <td align="center"><a href="https://mirasim.ai" title="Mirasim"><img src="docs/sponsors/mirasim.png" alt="Mirasim" width="96"></a></td>
  30. <td>Provides substantial API credits for the upcoming v3.0, with continued API support to follow.</td>
  31. </tr>
  32. </table>
  33. </div>
  34. <p align="center">
  35. <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;&#120;&#50;&#49;&#50;&#48;&#48;&#54;&#48;&#50;&#48;&#53;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;?subject=Unity-Skills%20Sponsorship%20Inquiry">Become a sponsor →</a>
  36. </p>
  37. <!-- sponsors:end -->
  38. ## 📈 Project Contribution Rankings
  39. <p align="center">
  40. <a href="https://trendshift.io/repositories/27085?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-27085" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/27085/daily?language=C%23" alt="Besty0728%2FUnity-Skills | Trendshift" width="250" height="55"/></a>
  41. <a href="https://trendshift.io/repositories/27085?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-27085" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/27085/weekly?language=C%23" alt="Besty0728%2FUnity-Skills | Trendshift" width="250" height="55"/></a>
  42. <a href="https://trendshift.io/repositories/27085?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-27085" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/27085/monthly?language=C%23" alt="Besty0728%2FUnity-Skills | Trendshift" width="250" height="55"/></a>
  43. </p>
  44. ## 🤝 Acknowledgments
  45. This project is a deep refactoring and feature extension based on the excellent concept of [unity-mcp](https://github.com/CoplayDev/unity-mcp).
  46. ---
  47. ## 🚀 Core Features
  48. - 🛠️ **873 REST Skills Toolkit**: 57 source files across 55 categories, plus 30 advisory design modules, with Batch operations.
  49. - ⚡ **UnityCLI Support**: Bind UnityCLI to cold-start the bound project — no need to launch Unity Hub.
  50. - 🔐 **Three-Tier Permission Modes**: Approval / Auto / Bypass with dual approval channels, aligned with Claude Code permission modes.
  51. - 🤖 **6 Major IDEs Native Support**: Claude Code / Antigravity / Codex / Cursor / OpenCode / Kimi Code — one-click install and use.
  52. - 🛡️ **Transactional Atomicity**: Failed operations auto-rollback, leaving scenes clean.
  53. - 🌍 **Multi-Instance Control**: Automatic port discovery and global registry for controlling multiple Unity projects at once.
  54. - 🔗 **Stable Long Connections**: Configurable request timeout (default 15 minutes), automatic recovery after Domain Reload.
  55. - 🛡️ **Anti-Hallucination Guardrails**: Each Skill module includes DO NOT lists and routing rules.
  56. ---
  57. ## 🛡️ Built for Trust: The Governance Layer
  58. An AI driving the Editor writes to real scenes, prefabs and `.meta` files. The interesting question isn't whether it *can* — it's what happens when it gets something wrong. UnitySkills answers that at four points in the call lifecycle:
  59. - **Before execution**: `?mode=dryRun` / `?mode=plan` rehearsal — returns parameter validation and an impact estimate, writes nothing.
  60. - **At execution**: the server derives high-risk gating (NeverInSemi) from each skill's risk metadata — gating never depends on the AI behaving well; **Allowlist** grants a persistent per-skill pass.
  61. - **After execution**: every call, grant, revoke and blocked hit lands in a JSONL audit trail, browsable in the panel; deletions are audited too.
  62. - **After a mistake**: five types of persistent snapshots survive Domain Reloads; `workflow_undo_task` rolls back one task, not the whole project; `POST /skills/batch` runs as a transaction (cross-step `$ref`, rollback on failure, `?diff=1` net change).
  63. Full mechanics → [Operating Modes & Governance](docs/OPERATING_MODES.md)
  64. ### How this compares
  65. | Dimension | UnitySkills | Typical MCP bridge | Unity's official AI Assistant |
  66. | :--- | :--- | :--- | :--- |
  67. | **Permission granularity** | Per-operation: three modes (Approval / Auto / Bypass) + risk metadata on every skill + per-skill Allowlist | No permission model — once connected, the whole tool surface is callable | Per-client trust (Pending Connections → Allow / Revoke); after approval, calls are not distinguished by operation |
  68. | **Audit** | Structured JSONL for every call / grant / revoke / block, browsable in-panel; deletions are audited too | Process logs only; no structured per-call record | Surfaced as chat history and checkpoints rather than a per-operation audit record |
  69. | **Rollback granularity** | Per-task, five snapshot types, file and `.meta` content-addressed, persists across sessions | Relies on Unity's native Undo stack; not guaranteed to survive a Domain Reload | Project-wide checkpoints taken per prompt — restoring rewinds the entire project to that point |
  70. | **Pre-execution preview** | `?mode=dryRun` / `?mode=plan` — semantic parameter validation + impact estimate, nothing written | No equivalent found | No pre-execution parameter validation or impact preview found |
  71. | **Batch transactions** | `POST /skills/batch` — fail-fast / `continueOnError`, cross-step `$ref`, rollback, `?diff=1` net change | Per-call tool invocations, no transaction semantics | Not exposed as a batch transaction |
  72. > The **UnitySkills** column describes mechanisms that exist in this repository and can be checked against the source or by calling the endpoints. The other two columns reflect **public material and open-source repositories surveyed in 2026-07**; they characterise a class of tooling rather than any specific project, and those capabilities may have changed since.
  73. ---
  74. ## 🔐 Operating Modes
  75. UnitySkills ships with a true server-side permission system aligned with Claude Code permission modes. All mode switching happens in the Unity panel: **Window > UnitySkills** → ⚙ Settings → **Server** section (chat trigger words are no longer supported).
  76. | Mode | Default | Behavior |
  77. |:-----|:-------:|:---------|
  78. | **Approval** | — | Server returns a grant token; the AI executes after user approval |
  79. | **Auto** | New installs | FullAuto skills run directly; high-risk ops (NeverInSemi) are auto-blocked |
  80. | **Bypass** | Existing installs (upgrade) | All skills run unrestricted; only the optional high-risk confirmation gate remains |
  81. Upgrading users are detected automatically and stay on **Bypass**, preserving the previous Full-Auto behavior with no action required. Dual approval channels (Dialog / Panel), the audit log (`Library/UnitySkillsAudit.jsonl`), Allowlist and installer details → [Operating Modes & Governance](docs/OPERATING_MODES.md).
  82. > 30 advisory design modules (architecture, performance, design patterns, testability, package-specific source rules, etc.) are available in all modes and loaded on demand.
  83. ---
  84. ## 🏗️ Quick Install Supported IDE/Terminals
  85. This project has been deeply optimized for the following environments (tools not listed are not necessarily unsupported — they just lack a quick installer; use ***Custom Installation*** instead. Per-tool skill directories are listed in the Manual Installation section below):
  86. | AI Terminal | Support Status | Notes |
  87. | :--- | :---: | :--- |
  88. | **Antigravity** | ✅ Supported | Open Agent Skills standard; shares `.agents/skills/` with Codex in workspace mode |
  89. | **Claude Code** | ✅ Supported | Intelligent Skill intent recognition, supports complex multi-step automation |
  90. | **Codex** | ✅ Supported | Supports `$skill` explicit invocation and implicit intent recognition |
  91. | **Cursor** | ✅ Supported | Auto-discovers skill directories; supports `/skill-name` explicit invocation |
  92. | **Kimi Code** | ✅ Supported | Native skill directory discovery; supports `/skill:unity-skills` explicit invocation |
  93. | **OpenCode** | ✅ Supported | Native workspace and global skill directory discovery |
  94. ---
  95. ## 🏁 Quick Start
  96. > **Overview**: Install Unity Plugin → Start UnitySkills Server → AI Uses Skills
  97. <p align="center">
  98. <img src="docs/images/installation-demo.gif" alt="一键安装演示" width="800">
  99. </p>
  100. ### 1. Install Unity Plugin
  101. Add via Unity Package Manager using Git URL:
  102. **Stable Version (main)**:
  103. ```
  104. https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity
  105. ```
  106. **Beta Version (beta)**:
  107. ```
  108. https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity#beta
  109. ```
  110. **Specific Version** (e.g., v1.6.0):
  111. ```
  112. https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity#v1.6.0
  113. ```
  114. > 📦 All version packages are available on the [Releases](https://github.com/Besty0728/Unity-Skills/releases) page
  115. ### 2. Open the Panel & Start Server
  116. In Unity, open menu: `Window > UnitySkills` (or press <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>U</kbd>). Use the server toggle switch in the top bar to start it; once started it auto-restarts across domain reloads.
  117. > ⏳ `script_*`, `debug_force_recompile`, `debug_set_defines`, some asset reimports, and package changes may trigger compilation or Domain Reload. Temporary REST unavailability during that window is expected; wait a moment and retry.
  118. ### 3. One-Click AI Skills Configuration
  119. 1. Open `Window > UnitySkills` and go to the **AI Config** tab.
  120. 2. Select the corresponding terminal icon and click **"Install"** — the installer copies the `unity-skills~/` template from the package to the target location, plus the `unity-skills-eval~/` evaluation skill into a sibling `unity-skills-eval/` folder (invoke it with `/unity-skills-eval`); no manual copying needed. A Custom Path install writes only the main skill.
  121. > 🔄 **Auto-sync on update**: after you upgrade the package, tools you already installed are refreshed to the new version automatically (nothing new is ever installed for you); turn it off in ⚙ Settings ▸ **AI Tools**.
  122. >
  123. > **Codex Note**: Antigravity and Codex share `.agents/skills/` in workspace mode — installing once makes the skill available to both; no `AGENTS.md` declaration needed for Codex.
  124. 📘 For complete installation and usage instructions, see: [Setup Guide](docs/SETUP_GUIDE.md) | [安装指南](docs/SETUP_GUIDE_CN.md)
  125. <details>
  126. <summary><b>4. Manual Skills Installation (Optional)</b></summary>
  127. If one-click installation is not supported or preferred, follow this **standard procedure** for manual deployment (applicable to all tools supporting Skills):
  128. #### ✅ Standard Installation Method A
  129. 1. **Custom Installation**: In the installation interface, select the "Custom Path" option to install Skills to any directory you specify (e.g., `Assets/MyTools/AI`) for easier project management.
  130. #### ✅ Standard Installation Method B
  131. 1. **Locate Skills Source Directory**: The `SkillsForUnity/unity-skills~/` directory in the UPM package is the distributable Skills template (root directory contains `SKILL.md`).
  132. 2. **Find the Tool's Skills Root Directory**: Different tools have different paths; refer to the tool's documentation first.
  133. 3. **Copy Completely**: Copy the entire contents of `unity-skills~/` to the tool's Skills root directory (rename to `unity-skills/`). Optionally copy `unity-skills-eval~/` beside it as `unity-skills-eval/` to get the `/unity-skills-eval` evaluation skill.
  134. 4. **Create agent_config.json**: Create an `agent_config.json` file in the `unity-skills/scripts/` directory:
  135. ```json
  136. {"agentId": "your-agent-name", "installedAt": "2026-02-11T00:00:00Z"}
  137. ```
  138. Replace `your-agent-name` with the name of your AI tool (e.g., `claude-code`, `antigravity`, `codex`, `cursor`).
  139. 5. **Directory Structure Requirements**: After copying, maintain the structure as follows (example):
  140. - `unity-skills/SKILL.md`
  141. - `unity-skills/skills/`
  142. - `unity-skills/references/`
  143. - `unity-skills/scripts/unity_skills.py`
  144. - `unity-skills/scripts/agent_config.json`
  145. 6. **Restart the Tool**: Let the tool reload the Skills list.
  146. 7. **Verify Loading**: Trigger the Skills list/command in the tool (or execute a simple skill call) to confirm availability.
  147. #### 🔎 Common Tool Directory Reference
  148. The following are verified default directories (if the tool has a custom path configured, use that instead):
  149. - Claude Code: `~/.claude/skills/`
  150. - Antigravity: `~/.gemini/antigravity/skills/` (global) or `.agents/skills/` (workspace)
  151. - OpenAI Codex: `~/.agents/skills/` (global) or `.agents/skills/` (workspace, shared with Antigravity)
  152. - Cursor: `~/.cursor/skills/` (global) or `.cursor/skills/` (workspace); also auto-discovers `.agents/skills/`
  153. - OpenCode: `~/.config/opencode/skills/` (global) or `.opencode/skills/` (workspace)
  154. - Kimi Code: `~/.kimi-code/skills/` (global, or `$KIMI_CODE_HOME/skills/`) or `.kimi-code/skills/` (project); also auto-discovers `.agents/skills/`
  155. #### 🧩 Other Tools Supporting Skills
  156. If you're using other tools that support Skills, install according to the Skills root directory specified in that tool's documentation. As long as the **standard installation specification** is met (root directory contains `SKILL.md` and maintains `skills/`, `references/`, and `scripts/` structure), it will be correctly recognized.
  157. </details>
  158. ---
  159. <details>
  160. <summary><b>📦 Skills Category Overview (873)</b></summary>
  161. | Category | Count | Core Functions |
  162. | :--- | :---: | :--- |
  163. | **YooAsset** | 40 | Hot-update bundle builds/Collector full CRUD/BuildReport asset and dependency analysis/PlayMode runtime validation/Reporter-Debugger-AssetArtScanner tools |
  164. | **Behavior** | 10 | Unity Behavior graph assets/agents/blackboard variables (com.unity.behavior, reflection-based) |
  165. | **HybridCLR** | 12 | HybridCLR hot-update settings/codegen/DLL compile & copy pipeline (com.code-philosophy.hybridclr, reflection-based) |
  166. | **Workflow** | 42 | Persistent history/Tiered task snapshots/Content-addressed file store/Auto-clean/Session-level undo/Rollback/Clear history/Bookmarks/Batch query-preview-execute jobs |
  167. | **Cinemachine** | 34 | 2.x/3.x dual version auto-install/MixingCamera/ClearShot/TargetGroup/Spline |
  168. | **Netcode** | 39 | Netcode for GameObjects setup/prefabs/lifecycle/host-server-client workflows/NGO 2.5+ attachable & component-controller helpers |
  169. | **UI** | 29 | Canvas/Button/Text/InputField/Dropdown/ScrollView/Layout/Alignment/Image and selectable utilities |
  170. | **UI Toolkit** | 31 | UXML/USS file management/UIDocument/PanelSettings full property read-write/Template generation/Structure inspection/Batch create/Runtime data binding/UXML upgrade/World-space panels |
  171. | **ShaderGraph** | 23 | Shader Graph create/inspect/blackboard edit/constrained node editing |
  172. | **ProBuilder** | 22 | ProBuilder shape creation/face-edge operations/UV tools/pivot edits/batch creation/mesh combination |
  173. | **XR** | 22 | XR rig setup/interactors/interactables/teleportation/continuous move/UI/haptics/interaction layers |
  174. | **Material** | 21 | Batch material property modification/HDR/PBR/Emission/Keywords/Render queue |
  175. | **PostProcess** | 10 | SRP post-processing effect management |
  176. | **GameObject** | 19 | Create/Find/Transform sync/Batch operations/Hierarchy management/Rename/Duplicate |
  177. | **Perception** | 18 | Scene summary/health checks/stack detection/context export/dependency analysis/hotspots/diff/tag-layer stats/performance hints |
  178. | **Volume** | 9 | VolumeProfile/Volume/VolumeComponent creation and parameter editing |
  179. | **Validation** | 16 | Project validation/Empty folder cleanup/Reference detection/Mesh collider/Shader errors |
  180. | **URP** | 7 | URP asset/renderer/renderer feature inspection and edits |
  181. | **Decal** | 7 | URP Decal Projector create/inspect/configure/delete workflows |
  182. | **DOTween** | 21 | DOTweenAnimation editor-time setup and tuning |
  183. | **PrimeTween** | 5 | PrimeTween Free inspection, factory discovery, and runtime tween/sequence script generation |
  184. | **Editor** | 17 | Play mode runtime capture/Frame stepping/Live state inspect/Selection/Undo-Redo/Context retrieval/Change journal/Menu execution |
  185. | **Physics** | 12 | Raycast/SphereCast/BoxCast/Physics materials/Layer collision matrix |
  186. | **Script** | 12 | C# script create/Read/Replace/List/Info/Rename/Move/Analyze |
  187. | **Timeline** | 12 | Track create/Delete/Clip management/Playback control/Binding/Duration |
  188. | **Asset** | 12 | Asset import/Delete/Move/Copy/Search/Folders/Batch folder creation/Batch operations/Refresh |
  189. | **AssetImport** | 11 | Texture/Model/Audio/Sprite import settings/Label management/Reimport |
  190. | **Camera** | 12 | Scene View control/Game Camera create/Properties/Screenshot/Orthographic toggle/List |
  191. | **Graphics** | 11 | GraphicsSettings/QualitySettings/SRP asset operations |
  192. | **Package** | 11 | Package management/Install/Remove/Search/Versions/Dependencies/Cinemachine/Splines |
  193. | **Prefab** | 40 | Create/Instantiate/Overrides/Variants/Asset queries, components, hierarchy edits and atomic batches |
  194. | **Shader** | 11 | Shader create/URP templates/Compile check/Keywords/Variant analysis/Global keywords |
  195. | **Test** | 13 | Test run/Run by name/Categories/Template create/Summary statistics |
  196. | **Animator** | 10 | Animation controller/Parameters/State machine/Transitions/Assign/Play |
  197. | **Audio** | 10 | Audio import settings/AudioSource/AudioClip/AudioMixer/Batch |
  198. | **Cleaner** | 10 | Unused assets/Duplicate files/Empty folders/Missing script fix/Dependency tree |
  199. | **Component** | 18 | Add/Remove/Property config/Batch operations/Copy/Enable-Disable |
  200. | **Console** | 10 | Log capture/Clear/Export/Statistics/Pause control/Collapse/Clear on play |
  201. | **Debug** | 11 | Error logs/Compile check/Stack trace/Assemblies/Define symbols/Memory info/Editor health diagnose |
  202. | **Event** | 11 | UnityEvent listener management/Batch add/Copy/State control/List |
  203. | **Light** | 11 | Light create/Type config/Intensity-Color/Batch toggle/Probe groups/Reflection probes/Lightmaps |
  204. | **Particle** | 31 | Built-in ParticleSystem (Shuriken) create/inspect/configure: typed module patches, renderer, bursts, sub emitters, static analysis, playback control (play/pause/stop/simulate/emit), atomic batches, dryRun and sliced simulation jobs (not VFX Graph) |
  205. | **Model** | 10 | Model import settings/Mesh info/Material mapping/Animation/Skeleton/Batch |
  206. | **NavMesh** | 10 | Bake/Path calculation/Agent/Obstacle/Sampling/Area cost |
  207. | **Optimization** | 10 | Texture compression/Mesh compression/Audio compression/Scene analysis/Static flags/LOD/Duplicate materials/Overdraw |
  208. | **Profiler** | 10 | FPS/Memory/Texture/Mesh/Material/Audio/Rendering stats/Object count/AssetBundle |
  209. | **Scene** | 10 | Multi-scene load/Unload/Activate/Screenshot/Context/Dependency analysis/Report export |
  210. | **ScriptableObject** | 13 | Create/Read-Write/Serialized-property path write (nested/array/reference)/Batch set/Delete/Find/JSON import-export |
  211. | **Smart** | 10 | Scene SQL query/Spatial query/Auto layout/Snap to ground/Grid snap/Randomize/Replace |
  212. | **Terrain** | 10 | Terrain create/Heightmap/Perlin noise/Smooth/Flatten/Texture painting |
  213. | **Texture** | 10 | Texture import settings/Platform settings/Sprite/Type/Size search/Batch |
  214. | **Project** | 11 | Player builds/Render pipeline/Build settings/Package management/Layer/Tag/PlayerSettings/Quality |
  215. | **Addressables** | 8 | Addressable asset groups/Profiles/Labels/Build paths/Build/Entry add-remove (com.unity.addressables, reflection-based) |
  216. | **QFramework** | 20 | QFramework architecture-layer codegen/ViewController & UIKit panel codegen/UIKit settings/ResKit AssetBundle mark-build-clear/architecture scan/API doc query (no UPM package, reflection-based) |
  217. | **Sample** | 8 | Basic examples: Create/Delete/Transform/Scene info |
  218. > ⚠️ Most modules support `*_batch` batch operations. When operating on multiple objects, prioritize batch Skills for better performance.
  219. >
  220. > 🧠 `unity-skills/skills/` also includes **30 advisory design modules** for architecture, script design, performance, maintainability, Inspector guidance, and package-specific source rules.
  221. </details>
  222. ---
  223. ## 🧪 Evaluation Set
  224. A scored evaluation set (pack 1.2.0, 41 tasks) lets you test how well your AI agent drives UnitySkills on your own Unity project. Tasks live in [`SkillsForUnity/Evaluation~/pack/`](SkillsForUnity/Evaluation~/pack/): `manifest.json` plus `tasks/<ID>/{prompt.en.md, prompt.zh-CN.md, task.py}`. The scoring assertions are private and are not shipped with the package.
  225. | Track | Basic | Standard | Challenge |
  226. |-------|-------|----------|-----------|
  227. | **ops** (editor operations) | 6: S01 S03 S04 S06 S08 D01 | 7: T3 T4 T5 T7 T10 OS1 OS2 | 8: OC1–OC8 |
  228. | **dev** (development work) | 6: DB1–DB6 | 6: T1 T2 T9 DS1 DS2 DS3 | 8: DC1–DC8 |
  229. **Run it**: open the **Evaluation** tab in the UnitySkills window (pick tasks → copy the prompt to your agent → watch progress → read results), or tell your agent `/unity-skills-eval`. The copied prompt carries the full runner command for your install (bundled `Evaluation~/run_eval.py`, Python 3.9+, standard library only).
  230. **Prerequisites**:
  231. - Operating mode `Bypass`.
  232. - All 41 tasks run on URP; 12 of them (S01 S03 S04 S06 S08 D01 DB1–DB6) also run on Built-in. The other 29 are URP-only and need an empty project marked as dedicated in the Evaluation tab.
  233. - DB5, DC5, OC5, OS2 and T2 need `com.unity.ugui`.
  234. Each task temporarily adds assets under `Assets/__UnitySkillsEval/` and the runner restores your scenes afterwards. Reports are written to `Library/UnitySkills/eval/sessions/<sessionId>/report.json` and `report.md`; the grade follows the strict pass rate (≥90% excellent, ≥70% good, ≥50% pass).
  235. ---
  236. ## 📂 Project Structure
  237. ```bash
  238. .
  239. ├── SkillsForUnity/ # Unity Editor Plugin (UPM Package)
  240. │ ├── package.json # com.besty.unity-skills
  241. │ ├── unity-skills~/ # Cross-platform AI Skill Template (tilde-hidden, bundled with package)
  242. │ │ ├── SKILL.md # Main Skill Definitions (AI-readable)
  243. │ │ ├── scripts/
  244. │ │ │ └── unity_skills.py # Python Client Library
  245. │ │ ├── skills/ # 85 module docs (55 REST/module docs + 30 documentation-only docs)
  246. │ │ └── references/ # Unity Development References
  247. │ ├── unity-skills-eval~/ # /unity-skills-eval evaluation skill, installed beside unity-skills
  248. │ │ └── SKILL.md
  249. │ ├── Evaluation~/ # Evaluation set: run_eval.py runner, usk_eval/, pack/ (manifest + 41 tasks)
  250. │ └── Editor/
  251. │ ├── Locales/ # Decoupled JSON Localization Assets (en.json, zh-CN.json, ru.json)
  252. │ ├── Skills/ # Core Skill Logic (57 *Skills.cs files → 55 SkillCategory categories, 873 Skills)
  253. │ │ ├── SkillsHttpServer.cs # HTTP Server Core (Producer-Consumer)
  254. │ │ ├── SkillRouter.cs # Request Routing & Reflection-based Skill Discovery
  255. │ │ ├── WorkflowManager.cs # Persistent Workflow (Task/Session/Snapshot)
  256. │ │ ├── RegistryService.cs # Global Registry (Multi-instance Discovery)
  257. │ │ ├── GameObjectFinder.cs # Unified GO Finder (name/entityId/instanceId/path)
  258. │ │ ├── BatchExecutor.cs # Generic Batch Processing Framework
  259. │ │ ├── Localization.cs # Multi-Language Localization Engine
  260. │ │ └── ... # 873 Skills source code
  261. │ └── UI/ # UI Toolkit Windows & Controllers
  262. │ ├── UnitySkillsWindow.{cs,uxml,uss} # Main Dashboard Window
  263. │ ├── UnityCliWindow.{cs,uxml,uss} # Unity CLI Configuration Panel
  264. │ ├── AuditLogWindow.{uxml,uss} # Audit Log Viewer
  265. │ ├── Controllers/ # UI Tab & Widget Controllers
  266. │ └── Tabs/ # UXML Tab Layouts & Settings Drawer
  267. ├── docs/
  268. │ ├── SETUP_GUIDE.md # Complete Setup & Usage Guide (_CN version available)
  269. │ ├── OPERATING_MODES.md # Operating Modes & Governance (_CN version available)
  270. │ ├── images/ # README images
  271. │ └── sponsors/ # Sponsor logos
  272. ├── CHANGELOG.md # Version Update Log
  273. └── LICENSE # MIT License
  274. ```
  275. ---
  276. ## ⭐Star History
  277. <a href="https://www.star-history.com/?repos=Besty0728%2FUnity-Skills&type=date&logscale=&legend=top-left">
  278. <picture>
  279. <source media="(prefers-color-scheme: dark)" srcset="docs/star-history-dark.svg" />
  280. <source media="(prefers-color-scheme: light)" srcset="docs/star-history-light.svg" />
  281. <img alt="Star History Chart" src="docs/star-history-light.svg" />
  282. </picture>
  283. </a>
  284. ---
  285. ## 📄 License
  286. This project is licensed under the [MIT License](LICENSE).
  287. **Bundled font (separate license):** the editor window bundles a subsetted CJK font
  288. `SkillsForUnity/Editor/UI/Fonts/UnitySkillsCN-Regular.ttf`, derived from
  289. [Maple Mono](https://github.com/subframe7536/maple-font) (CN variant), licensed under the
  290. **SIL Open Font License 1.1** — not MIT. The full license and attribution travel with the
  291. font in that folder (`OFL.txt`, `THIRD-PARTY-NOTICES.md`).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.