unity-batch
Unified batch and async-job orchestration
Install / Use
npx skills add Besty0728/Unity-Skills --skill batchInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of unity-batch
unity-batch scores 85/100 on our quality scale, 2619th of 4,698 Development & Engineering skills we index.
Its SKILL.md is 22 KB long, well organised into 28 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 1,781 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so unity-batch is actively maintained.
- Our last check on 2026-11-04 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unity-batch compared with similar skills
All 4 of these similar skills score higher than unity-batch; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unity-batch (this skill)by Besty0728 | 85 | 1.8k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install unity-batch?
- Run
npx skills add Besty0728/Unity-Skills --skill unity-batch. The install tabs above show the steps for each supported agent. - Which AI agents does unity-batch work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is unity-batch safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is unity-batch still maintained?
- The repository was last updated about 2 months ago, so unity-batch is actively maintained.
Skill content
View source on GitHubname: unity-batch description: Unified batch and async-job orchestration
Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via
GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Operating on many objects at once
- Running or polling long async jobs
- Preview-then-commit bulk edits
- 一次性操作大量对象、运行或轮询长时异步任务、先预览后提交的批量编辑
Unity Batch Skills
Batch workflow orchestration for query, preview, execution, reports, and async jobs.
POST /skills/batch — several skills, one HTTP call
This is an HTTP endpoint, not a skill: do not send skills_batch to POST /skill/<name>. It runs a sequence of ordinary skills inside one main-thread job, which removes one round-trip and one main-thread wakeup per step — the single largest efficiency lever in this protocol when you have more than two writes to make.
POST /skills/batch
{
"steps": [
{"skill": "gameobject_create", "args": {"name": "Cube", "primitiveType": "Cube"}},
{"skill": "component_add", "args": {"instanceId": {"$ref": "$0.instanceId"}, "componentType": "Rigidbody"}}
],
"continueOnError": false
}
| Body field | Type | Default | Meaning |
|---|---|---|---|
| steps | array | required | {skill, args} objects, executed in order. Max 50 — more returns 400 + SEMANTIC_INVALID; split into several calls. |
| continueOnError | bool | false | false = fail-fast; true = record the failure and keep going. |
| params | object | none | Fills {"$param":"name"} placeholder nodes in step args (static substitution, resolved before $ref). |
Query: ?mode=dryRun validates every step without executing anything and never interrupts (the batch counterpart of the dryRun gate); ?mode=transactional is all-or-nothing with Undo rollback; ?diff=1 adds a net sceneDiff. ?mode=plan is not supported. Inter-step $ref ({"$ref":"$0.instanceId"}) and transactional details → SKILL_FULL.md.
mode/dryRun may equally be set in the body ("mode":"dryRun"|"transactional", "dryRun":true) — each of the two keys is resolved independently, query-first per key, so a query ?mode= and a body "dryRun" never fight over the same slot. The response always echoes what actually ran: top-level mode ("dryRun"|"transactional"|"execute") and dryRun (bool). An unrecognized query key or body top-level key (anything outside mode/dryRun/diff/steps/params/continueOnError) is rejected with 400 UNKNOWN_PARAM; a blank value on a recognized key (?mode=, ?dryRun=, ?diff=) is treated as if that key were simply omitted — it falls through to the other location or the default, it is not itself a rejection.
Reading the response. Whenever the batch ran at all the status is HTTP 200 and the verdict is in the body — only a rejected request (malformed body, >50 steps, unknown ?mode=) is a 4xx.
{"status":"partial","dryRun":false,"executed":2,"failed":1,
"results":[{"index":0,"skill":"...","status":"success","result":{...}},
{"index":1,"skill":"...","status":"error","error":{"errorCode":"...","error":"..."}},
{"index":2,"skill":"...","status":"skipped"}]}
- Top-level
status:completed(nothing failed),partial(some step failed), orrolled_back(transactional mode reverted everything). - Every step carries its
indexandskill, so a failure is locatable without diffing your input array.status:"skipped"means the batch had already halted before that step ran — it was never attempted, not "ran and did nothing". - Fail-fast (
continueOnError:false) stops at the first error and reports the rest asskipped. WithcontinueOnError:truefailures are recorded and later steps still run. - Authorization always interrupts,
continueOnErrornotwithstanding: a step answeringMODE_RESTRICTED/CONFIRMATION_REQUIREDhalts the batch and returns that step's full payload (grant token included) so you can complete the grant flow and resubmit the remaining steps.
Not the same thing as
batch_execute.batch_execute(confirmToken)commits one previewed bulk operation produced by abatch_preview_*skill (one verb over N objects, via a confirm token).POST /skills/batchcomposes N different skills over whatever targets you name, and takes no token. They do not substitute for each other, andPOST /skills/batchis not a way to skip the preview/confirm gate — abatch_executestep inside a batch still needs its ownconfirmToken.
When a step returns a jobId (async batch execution, tests, compiles), poll it with GET /jobs/{id} rather than the job_status skill: it runs in the light lane instead of the main-thread skill queue, and its payload is far smaller than a skill response — an order of magnitude cheaper per poll on a long job.
Operating Mode
本模块共 22 个 skill,按 Operation 区分为两类:
- 18 个 SemiAuto(query / preview / report / job 查询类):
batch_query_gameobjects/batch_query_components/batch_query_assets/batch_preview_rename/batch_preview_set_property/batch_preview_replace_material/batch_report_get/batch_report_list/job_status/job_progress/job_logs/job_list/batch_fix_missing_scripts/batch_standardize_naming/batch_set_render_layer/batch_replace_material/batch_validate_scene_objects/batch_cleanup_temp_objects。Approval 模式下可直接执行。 - 4 个 FullAuto(Execute 类,C# 未标
Mode走默认SkillMode.FullAuto):batch_execute/job_wait/job_cancel/batch_retry_failed。Approval 模式下首次调用返MODE_RESTRICTED,走 grant 协议。 - Auto / Bypass:两类都直接执行。不含 NeverInSemi 高危 skill(无 Delete/MayEnterPlayMode/MayTriggerReload 标记)。
注意:
batch_execute(confirmToken)本身放行,但它执行的 preview 内容可能包括对场景对象的删除/改属性等高影响动作 —— 请确保batch_preview_*返回的 sample/risk 字段已审阅。confirmToken 一次性消费、过期需重新 preview。
Surface profile (guide tier): batch_preview_* stays callable under every profile — a preview is read-only. When the operation a preview minted its confirmToken for lands in a category the active profile withdraws (GameObject / Component / Material under guide), the preview still succeeds and still returns its diff, but adds a surfaceExclusion object (manualDoc, hint, plus blockedSkill/blockedBy/surfaceProfile/category) warning that execute will be refused. At that point batch_execute / batch_retry_failed return SURFACE_EXCLUDED with surfaceProfile/category/operation/manualDoc/userControlled/hint at the top level of the response (not nested under details). The refusal does not consume the confirmToken — switch the profile back to full and the same token still executes, no new preview needed.
DO NOT (common hallucinations):
- Always call a
batch_preview_*skill first —batch_executerequires aconfirmTokenfrom a preview, it cannot be called directly batch_rundoes not exist → usebatch_execute(confirmToken)job_poll/job_resultdo not exist →job_status(or the cheaperGET /jobs/{id}) for state, then the skill named in itsresultHintfor the payloadbatch_delete/batch_movedo not exist → useassetmodule for asset-level operations
Routing:
- For running several different skills in one call →
POST /skills/batch(section above), notbatch_execute - For asset-level bulk operations (move, copy, delete) →
assetmodule - For workflow session/task undo tracking →
workflowmodule - For scene object validation →
batch_validate_scene_objects(this module) - For async job polling →
job_status/job_wait(this module)
Skills
batch_query_gameobjects
Query GameObjects with unified batch filters. queryJson supports name/path/instanceId/tag/layer/active/componentType/sceneName/parentPath/prefabSource/includeInactive/limit.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| queryJson | string | No | null | JSON query filter envelope |
| sampleLimit | int | No | 20 | Max sample objects returned |
batch_query_components
Query components with unified batch filters. Optional componentType narrows the result.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| queryJson | string | No | null | JSON query filter envelope |
| componentType | string | No | null | Optional component type constraint |
| sampleLimit | int | No | 20 | Max sample objects returned |
batch_query_assets
Query project assets by type, path pattern, and labels. Read-only.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| searchFilter | string | No | null | Raw Unity AssetDatabase filter string |
| folder | string | No | "Assets" | Search root folder |
| typeFilter | string | No | null | Asset type (prefix t: optional, e.g. Texture2D) |
| namePattern | string | No | null | Case-insensitive regex for filename |
| labelFilter | string | No | null | Asset label (prefix l: optional) |
| maxResults | int | No | 200 | Max results returned |
batch_preview_rename
Preview batch renaming. mode supports prefix / suffix / replace / regex_replace.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| queryJson | string | No | null | JSON query filter envelope |
| mode | string | No | "prefix" | Rename mode |
| prefix | string | No | null | Prefix to add |
| suffix | string | No | null | Suffix to add |
| search | string | No | null | Plain text search term |
| replacement | string | No | null | Plain text replacement |
| regexPattern | string | No | null | Regex search pattern |
| regexReplacement | string | No | null | Regex replacement text |
| sampleLimit | int | No | DefaultSampleLimit | Max preview items |
batch_preview_set_property
Preview setting a component property or field across queried targets.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| queryJson | string | No | null | JSON query filter envelope |
| componentType | string | Yes | - | Target component type |
| propertyName | string | Yes | - | Property or field name |
| value | string | No | null | Literal value |
| referencePath | string | No | null | Scene reference path |
| referenceName | string | No | null | Scene reference object name |
| assetPath | string | No | null | Asset reference path |
| sampleLimit | int | No | DefaultSampleLimit | Max preview items |
batch_preview_replace_material
Preview replacing Renderer materials across queried targets.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| queryJson | string | No | null | JSON query filter envelope |
| materialPath | string | Yes | - | Replacement material asset path |
| sampleLimit | int | No | DefaultSampleLimit | Max preview items |
batch_execute
Execute a previously previewed batch operation by confirmToken. Large operations return a jobId.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| confirmToken | string | Yes | - | Preview confirmation token |
| runAsync | bool | No | true | Run as async job |
| chunkSize | int | No | 100 | Batch execution chunk size |
| progressGranularity | int | No | 10 | Emit a progressEvent every N items processed |
runAsync: true (the default) or an item count above chunkSize returns status: "accepted" plus a jobId — poll it like any other job. Only the inline path (runAsync: false and items ≤ `
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
