SkillAgentSearch skills...

unity-batch

Unified batch and async-job orchestration

Install / Use

npx skills add Besty0728/Unity-Skills --skill batch

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

85/100

Supported Platforms

Universal

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.

Substance
30/30
Structure
18/20
Description
8/15
Adoption
14/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
unity-batch (this skill)by Besty0728851.8k53d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP 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.

name: 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), or rolled_back (transactional mode reverted everything).
  • Every step carries its index and skill, 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 as skipped. With continueOnError:true failures are recorded and later steps still run.
  • Authorization always interrupts, continueOnError notwithstanding: a step answering MODE_RESTRICTED / CONFIRMATION_REQUIRED halts 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 a batch_preview_* skill (one verb over N objects, via a confirm token). POST /skills/batch composes N different skills over whatever targets you name, and takes no token. They do not substitute for each other, and POST /skills/batch is not a way to skip the preview/confirm gate — a batch_execute step inside a batch still needs its own confirmToken.

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_execute requires a confirmToken from a preview, it cannot be called directly
  • batch_run does not exist → use batch_execute(confirmToken)
  • job_poll / job_result do not exist → job_status (or the cheaper GET /jobs/{id}) for state, then the skill named in its resultHint for the payload
  • batch_delete / batch_move do not exist → use asset module for asset-level operations

Routing:

  • For running several different skills in one call → POST /skills/batch (section above), not batch_execute
  • For asset-level bulk operations (move, copy, delete) → asset module
  • For workflow session/task undo tracking → workflow module
  • 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

View on GitHub
GitHub Stars1.8k
CategoryDevelopment
Updated1mo ago
Forks165

Languages

C#

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
unity-batch — Universal Skill: Install & Safety Check | SkillAgent