unity-batch

Orchestrates batch queries, preview-confirm-execute mutations, and async job polling in Unity scenes.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-batch-du-qwq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-batch
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills/skills/batch
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-batch-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applying the same change to dozens or hundreds of Unity GameObjects, components, or assets one by one is slow and error-prone, and long-running operations can block the editor without visibility into progress or failures. ## Core Features & Use Cases - Batch Queries: Filter GameObjects, components, and assets by name, tag, layer, type, path, or label with a unified JSON query envelope. - Preview-Confirm-Execute Mutations: Preview renames, property changes, material replacements, layer assignments, and cleanup operations, review the sample and risk output, then commit with a one-time confirmToken via batch_execute. - Async Job Management: Run large operations as background jobs, poll status and incremental progress events, stream logs, wait, cancel, and retry only failed items from a report. - Use Case: Rename 500 scene objects to a standardized naming convention by previewing the change with batch_standardize_naming, reviewing the sample output, executing it as an async job, and polling job_progress until completion. ## Quick Start Ask the AI to preview renaming all GameObjects tagged "Enemy" with a prefix, review the sample, then execute the confirmed batch and poll the job until it finishes.

Frequently Asked Questions about unity-batch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch rename GameObjects in Unity?

Use batch_preview_rename with a queryJson filter and a mode such as prefix, suffix, replace, or regex_replace to preview the changes. Review the sample output, then call batch_execute with the returned confirmToken to apply the rename.

How do I run a long Unity batch operation without blocking?

Call batch_execute with runAsync set to true, which returns a jobId for a background job. Poll progress with job_status or job_progress, stream logs with job_logs, or block with job_wait until a timeout elapses.

Can I retry only the failed items from a Unity batch job?

Yes, batch_retry_failed accepts a reportId from a previous execution and re-runs only the failed items. It returns a new jobId along with the originalReportId so you can track the retry separately.

Why does batch_execute fail when called directly?

batch_execute requires a confirmToken produced by a batch_preview_* skill, so it cannot be invoked standalone. The token is single-use and expires, meaning you must run a fresh preview if it lapses.

Does this support bulk asset move or delete operations?

No, asset-level bulk operations like move, copy, and delete are routed to the separate asset module. This module covers scene object queries, previewed mutations, validation, and async job management only.