Agent skill

Unity CLI

by AmaniDawn in AmaniDawn/DGame

安装和修复 DGame Unity CLI,使用内嵌 Pipeline 与项目级 Workflow 排查 CLI/MCP 连接,查询 Unity Editor/Development Player,执行编译、测试和受控验证。涉及 CLI 安装、连接配置或实际 Unity 状态时使用;纯源码或文档任务不连接 Editor。

MITAuto-check passedGame Development

Install Unity CLI

skills CLI
$ npx skills add AmaniDawn/DGame --skill unity-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AmaniDawn/DGame unity-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AmaniDawn/DGame.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/unity-cli .claude/skills/unity-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
unity-cli
GitHub stars
169
Token cost
~554 tokens
SKILL.md length
114 words
Files
3 (incl. references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

安装和修复 DGame Unity CLI,使用内嵌 Pipeline 与项目级 Workflow 排查 CLI/MCP 连接,查询 Unity Editor/Development Player,执行编译、测试和受控验证。涉及 CLI 安装、连接配置或实际 Unity 状态时使用;纯源码或文档任务不连接 Editor。

  • Game Development work in your project
  • SKILL.md covers 版本约束, 执行入口, 不变量 and 常用命令
  • Calls python

What it does

Unity CLI is an agent skill from AmaniDawn/DGame. 安装和修复 DGame Unity CLI,使用内嵌 Pipeline 与项目级 Workflow 排查 CLI/MCP 连接,查询 Unity Editor/Development Player,执行编译、测试和受控验证。涉及 CLI 安装、连接配置或实际 Unity 状态时使用;纯源码或文档任务不连接 Editor。

Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/operations.md`).

It sits in Game Development. It works with Unity, Model Context Protocol and Python. The repository describes itself as: 根据TEngine框架,结合工作经验,修改和增加一些实用性拓展修改的框架(包括但不限于工具方法,工具编辑器,部分底层逻辑调整)。不合入TEngine,主要是不想让TEngine太冗杂。 The licence is MIT.

When your agent uses it

  • Game Development work in your project

Example prompts

  • “/unity-cli”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit df0e6f4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unity CLI loads about 554 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 43 tokens; SKILL.md has 114 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~554
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AmaniDawn/DGame at commit df0e6f4, republished under its MIT licence (© AmaniDawn). 114 words, ~554 tokens.

Download SKILL.mdSave it as .claude/skills/unity-cli/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
unity-cli
description
安装和修复 DGame Unity CLI,使用内嵌 Pipeline 与项目级 Workflow 排查 CLI/MCP 连接,查询 Unity Editor/Development Player,执行编译、测试和受控验证。涉及 CLI 安装、连接配置或实际 Unity 状态时使用;纯源码或文档任务不连接 Editor。

DGame Unity CLI

版本约束

本项目 Unity CLI 的指定版本以 tool-versions.json 的 unityCli 字段为唯一依据,操作前读取该值。安装、修复及 PATH 回退都必须匹配该值;doctor 对实际 --version 做精确比较,不匹配时报告 blocked,不自动替换工具。

beta 渠道或 latest 不代表本项目指定版本。用户明确要求调整版本时,更新版本配置,再按操作规程重新验收。

执行入口

从仓库根目录运行 python .agents/scripts/workflow.py doctor。脚本固定把 GameUnity 作为 Unity 工程;CLI 优先使用 GameUnity/Tools/unity.exe,文件缺少时从系统 PATH 查找 unity。此 CLI 与 Unity Editor 自身的 Unity.exe 是不同程序。

用户要求安装或修复 CLI 时,按 操作规程 的安装与验收步骤处理。常规使用先运行 python .agents/scripts/workflow.py doctor 记录当前 CLI 的绝对路径、版本和 SHA-256,再运行 python .agents/scripts/workflow.py unity list 获取当前 DGame 工程注册命令。查询示例:python .agents/scripts/workflow.py unity query list_open_scenes。

用户要求 MCP 接入时,使用 CLI 自带的 mcp stdio 服务,固定 CLI 和工程的绝对路径;具体配置与验证见操作规程。

不变量

  • Unity Editor 查询、编译、测试和写入串行;只绑定当前 DGame/GameUnity 的绝对路径。新操作前要求唯一实例且 ready;已审核的状态轮询允许观察 busy/compiling。
  • 源码使用代码编辑工具修改;CLI 与 MCP 都只调用已审核的查询和验证能力,不绕过 Workflow 的写入预览与审批。
  • 未知命令、任意 eval、菜单透传和跨工程实例默认阻塞。
  • 写入操作先 preview,再由用户明确确认后执行;请求超时先检查实际状态,禁止自动重放。
  • 测试先发现用例,分别核对模式、筛选器、执行数和终态;零用例、全跳过、失败或取消都不通过。
  • 缺少工具、命令或连接时报告具体原因。安装、替换和配置按用户当前任务及已有授权处理;Workflow 本身不会自动安装、升级或启动 Editor。
  • 不将 Pipeline 实例描述文件中的鉴权信息输出到日志或提交到仓库。

常用命令

powershell
python .agents/scripts/workflow.py doctor
python .agents/scripts/workflow.py check
python .agents/scripts/workflow.py unity list
python .agents/scripts/workflow.py unity query list_open_scenes
python .agents/scripts/workflow.py unity runtime-status --runtime-path <player-working-directory>
python .agents/scripts/workflow.py unity preview <mutation> --params-file request.json
python .agents/scripts/workflow.py verify --profile code
python .agents/scripts/workflow.py verify --profile unity --test-filter GameLogic

CLI 启动参数以当前可执行文件的帮助为准;Editor 命令以实时注册描述和 GameUnity/Packages/com.unity.pipeline/Documentation~ 为准。截图、资源写入、构建和 Player 操作需要单独验证和授权。

配置表导出交给 luban-dev,业务框架 API 交给 dgame-dev。

© AmaniDawn, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .agents/skills/unity-cli of AmaniDawn/DGame.

  • SKILL.md
  • agents/openai.yaml
  • references/operations.md

Open the folder on GitHubat commit df0e6f4

Compare with similar skills

Unity CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unity CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unity CLI this skillAmaniDawn/DGame169—~554Automated safety check: PassMIT
Locus Unity BridgeMisaka-Mikoto-Tech/agent-skills275—~4kAutomated safety check: PassMIT
Unity PluginTomLeeLive/openclaw-unity-plugin106—~5.1kAutomated safety check: PassApache-2.0
Fmodel Unpackpa001024/dna-builder134—~2.6kAutomated safety check: PassMIT
Unreal Enhanced Input Setupkevinpbuckley/VibeUE717—~2.4kAutomated safety check: PassMIT
Assets Find Built InIvanMurzak/Unity-MCP4.4k—~994Automated safety check: PassApache-2.0

Similar skills

  • Locus Unity Bridge

    Misaka-Mikoto-Tech/agent-skills

    A skill your agent uses when an agent needs to inspect or control a real Unity Editor through Locus, especially when Unity MCP is unavailable, named-pipe discovery is needed, C must be executed, or…

    275 GitHub stars~4k tokensUpdated 16 days ago
    Game DevelopmentAuto-check passed
  • Unity Plugin

    TomLeeLive/openclaw-unity-plugin

    Control Unity Editor via OpenClaw Unity Plugin. An agent skill from TomLeeLive/openclaw-unity-plugin.

    106 GitHub stars~5.1k tokensUpdated 29 days ago
    Game DevelopmentAuto-check passed
  • Fmodel Unpack

    pa001024/dna-builder

    This skill documents how to use the fmodel-mcp toolkit (a CUE4Parse-based .NET CLI plus a thin Python MCP server) to inspect and export Unreal Engine game assets — pak files, textures, meshes…

    134 GitHub stars~2.6k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Unreal Enhanced Input Setup

    kevinpbuckley/VibeUE

    Creates and wires Unreal Engine Enhanced Input assets through VibeUE's InputService: Input Actions, Mapping Contexts, key bindings, triggers and modifiers.

    717 GitHub stars~2.4k tokensUpdated 6 days ago
    Game DevelopmentAuto-check passed
  • Assets Find Built In

    IvanMurzak/Unity-MCP

    Search the built-in assets of the Unity Editor (located at Resources/unitybuiltinextra).

    4.4k GitHub stars~994 tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed
  • Editor Application Set State

    IvanMurzak/Unity-MCP

    Start / stop / pause the Unity Editor 'playmode'. An agent skill from IvanMurzak/Unity-MCP.

    4.4k GitHub stars~981 tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed

More from AmaniDawn/DGame

  • Luban Dev

    AmaniDawn/DGame

    DGame Luban 游戏配置全栈工具,支持枚举/Bean/数据表/字段/数据行的增删改查、配置校验、引用检查、导表脚本调用、ConfigMgr 封装与运行时消费链路排查。触发场景:(1) 编辑 GameConfig/Datas 下的游戏配置数据(道具表、文本表、模型表、音效表、特效表、GM 表等),(2) 新增/修改/删除配置表结构、字段、枚举或 Bean,(3) 处理…

    169 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Dgame Dev

    AmaniDawn/DGame

    DGame Unity 项目开发指导。触发词:DGame, GameModule, UIWindow, UIWidget, UIModule, AddUIEvent, GameEvent, GameEventDriver, EEventGroup, LoadAssetAsync, LoadGameObjectAsync, SetSprite, ConfigSystem, HybridCLR…

    169 GitHub stars~892 tokensUpdated today
    Auto-check passed

Questions about Unity CLI

What does Unity CLI do?

安装和修复 DGame Unity CLI,使用内嵌 Pipeline 与项目级 Workflow 排查 CLI/MCP 连接,查询 Unity Editor/Development Player,执行编译、测试和受控验证。涉及 CLI 安装、连接配置或实际 Unity 状态时使用;纯源码或文档任务不连接 Editor。. Unity CLI is an agent skill from AmaniDawn/DGame.

When should I use Unity CLI?

Unity CLI fits situations like: game Development work in your project.

How do I install Unity CLI in Claude Code?

Run `npx skills add AmaniDawn/DGame --skill unity-cli -a claude-code`. Or copy the skill folder (.agents/skills/unity-cli in AmaniDawn/DGame) into .claude/skills/unity-cli in your project. Claude Code loads it when a task matches its description.

How do I install Unity CLI in Codex?

Run `npx skills add AmaniDawn/DGame --skill unity-cli -a codex`. Or copy the skill folder (.agents/skills/unity-cli in AmaniDawn/DGame) into .agents/skills/unity-cli in your project. Codex loads it when a task matches its description.

Can I use Unity CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AmaniDawn/DGame --skill unity-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unity-cli, .gemini/skills/unity-cli, .github/skills/unity-cli and .opencode/skills/unity-cli in your project.

What does Unity CLI need to run?

Going by SKILL.md and its folder, Unity CLI needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Unity CLI access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Unity CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Unity CLI use?

Unity CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unity CLI use?

About 554 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Unity CLI?

Skills that share tags, products or a category with Unity CLI: Locus Unity Bridge (Misaka-Mikoto-Tech/agent-skills, 275 stars), Unity Plugin (TomLeeLive/openclaw-unity-plugin, 106 stars), Fmodel Unpack (pa001024/dna-builder, 134 stars) and Unreal Enhanced Input Setup (kevinpbuckley/VibeUE, 717 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unity CLI?

AmaniDawn (a GitHub user) maintains it in AmaniDawn/DGame, which has 169 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: AmaniDawn/DGame on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.