unity-cli

unity-cli is a skill for Codex from Alex-Rachel/TEngine. It costs 65 tokens per session (706 once invoked), scanned A, original, MIT.

A command-line tool for checking and operating a Unity project, including its open scenes, game objects, assets, tests, compilation, and build checks. Unity is a game engine and editor.

In plain words
What is it for?
Use it to inspect scenes, Prefabs, components, and the asset database; run Unity tests; compile; and perform build prechecks.
Why use it?
It lets an agent verify real Unity state instead of guessing from source files. It also adds checks before changes and reports blocked or uncertain operations.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: mentions Codex.

Good fit Use it to inspect scenes, Prefabs, components, and the asset database; run Unity tests; compile; and perform build prechecks.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/alex-rachel/tengine/unity-cli
About the project

TEngine is a Unity framework for building games, providing modules for asynchronous work, hot updates, asset management, configuration tables, and user interfaces. It is for Unity developers and teams making commercial projects across desktop, mobile, web, and WeChat Mini Game targets, with catalogue skills supporting its AI-assisted development workflow.

Alex-Rachel/TEngine · 2,379 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Alex-Rachel/TEngine --skill unity-cli
Clone the repo
git clone --depth 1 https://github.com/Alex-Rachel/TEngine

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for unity-cli

README.md
[![agentmods](https://agentmods.dev/badge/skills/alex-rachel/tengine/unity-cli/github.svg)](https://agentmods.dev/skills/alex-rachel/tengine/unity-cli)
Your own site
<a href="https://agentmods.dev/skills/alex-rachel/tengine/unity-cli"><img src="https://agentmods.dev/badge/skills/alex-rachel/tengine/unity-cli/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for unity-cli

Your own site · 80×15
<a href="https://agentmods.dev/skills/alex-rachel/tengine/unity-cli"><img src="https://agentmods.dev/badge/skills/alex-rachel/tengine/unity-cli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 65 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 706 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00065 $0.00706
Opus 5.5 $0.00026 $0.00282
Sonnet 5.5 $0.00013 $0.00141
Haiku 4.5 $0.00006 $0.00071

Measured 23d ago against content hash e51666627e94, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

unity-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 23d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

UnityProject/.codex/skills/unity-cli/SKILL.md · 43 lines

What it actually says

Unity CLI

执行入口

从 Unity 项目执行 python .codex/scripts/workflow.py doctor,或通过绝对路径调用该脚本。路径由脚本定位,不借用其他打开的工程。 CLI 为 Tools/unity.exe,不是 Unity Editor 自身的同名可执行文件。

先运行 unity list 获取当前注册命令,再按需阅读 操作规程。 示例:python .codex/scripts/workflow.py unity query list_open_scenes。 编译/测试:python .codex/scripts/workflow.py verify --profile unity。

不变量

  • 开始新操作前确认指定工程唯一且 ready。编译、导入、测试和写入串行;状态轮询不要求 ready,否则无法观察忙操作。
  • 源码用代码编辑工具修改,不用 Pipeline 文本写入、eval 或 menu 绕过编辑/授权规则。
  • 查询与写入不能只看名字前缀。未知命令、菜单、eval 默认不允许通过自动化入口执行。
  • 写入先 preview,展示目标、输入和影响范围;得到用户明确确认后 approve,最后 apply。高风险单独确认。
  • dry_run/confirm 是各命令自行实现的约定,必须核实命令实际支持;Undo 不能恢复所有资产、设置和包操作。
  • 请求发送后超时视作结果未知,查询状态或检查实际目标,禁止自动重放写入。
  • 测试先发现用例,分别运行 EditMode/PlayMode,轮询终态并检查实际执行数。零用例、全部跳过、失败、取消、结果不匹配均不能通过。
  • 没有连接、命令、授权或必需依赖时报告 blocked;不安装、不升级、不连接其他项目兜底。

权威资料

根据当前任务读取 Packages/com.unity.pipeline/Documentation~/ 中:

场景 包内文档
连接、鉴权、Player connectivity.md、runtime-setup.md
安全、路径、Undo safety-and-mutations.md、authoring-commands.md
编译、测试、构建 commands/build-and-compilation.md
资源、对象、Prefab commands/assets-and-files.md、commands/gameobjects-and-components.md、commands/prefabs.md
视觉、场景、设置 commands/capture.md、commands/scenes.md、commands/project-settings.md
新增项目命令 creating-commands.md

实时命令描述优先于复制的示例。Pipeline 更新后重新验证契约,不假定版本兼容。 截图是证据,不等于视觉验收通过。输出报告需区分机器验证和人工确认。

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 23d ago First seen · 43 lines · 65 tokens per session scan A e51666627e94

Subscribe to this mod's changes

unity-cli is a skill published in the GitHub repository Alex-Rachel/TEngine (2,379 stars, last pushed 24d ago), licensed MIT. It adds 65 tokens to every session and 706 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-23.

Related

Other skills, from other repositories

godot-development

Godot 4 reference patterns: signal-vs-call and physics-body decision tables, resource sharing traps, input handling, a common mistakes catalog, a GDScript to C# rosetta, typed class structure, pooling, autoloads, GUT tests, and collision layer constants. Use when designing, writing, or reviewing Godot 4 code.

HermeticOrmus/LibreGameDev-Claude-Code · 77 tokens

tests-run

Execute Unity tests (EditMode or PlayMode) and return per-test results. Supports filtering by test assembly, namespace, class, and method. Refreshes the AssetDatabase first; defers execution across domain reloads if scripts changed. Precondition: every open scene must be saved — dirty scenes abort the run.

IvanMurzak/Unity-MCP · 68 tokens

roblox-studio-workflow

Modify living Roblox Studio projects safely: inspect Explorer and execution locations, preserve existing structure, reuse modules/remotes, create meaningful Instances, apply Attributes and CollectionService tags, test server/client and multiple devices, inspect Output, and remove experiments/debug objects. Use when an…

gamedev-skills/awesome-gamedev-agent-skills · 96 tokens

godot-testing

Use when writing tests for Godot projects — TDD workflow with GUT and gdUnit4, covers both GDScript and C#.

jame581/GodotPrompter · 32 tokens

et-test-run

ET test execution and failure debugging workflow for WOW. Use when building before tests, cleaning Logs, running server or Hotfix tests through ET.App Test commands, running Unity Editor tests through UnityBridge UnityTestRunRequest, reading Logs/All.log, judging results, and diagnosing failed or unmatched tests.

FlameskyDexive/Legends-Of-Heroes · 63 tokens

et-unitybridge

UnityBridge workflow for AI operations in Unity Editor. Use when checking UnityBridge connectivity, Unity compile or PlayMode state, running deferred UnityBridge commands, operating assets/scenes/GameObjects/Inspector/Prefabs/GameView/screenshots, running Editor tests, or troubleshooting UnityBridge responses.

FlameskyDexive/Legends-Of-Heroes · 61 tokens