skills.rest
ethanJPope
ethanJPopeCOMMUNITY
Explore all skills by this author →
GitHub

unity-batch

Orchestrates batch operations and async jobs across Unity scene objects and assets.

Updated Aug 18, 2026
Search Tags:#unity#preview#batch operations#bulk edit#async jobs#scene automation#job polling
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-batch-ethanjpope
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-batch
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/batch
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-batch-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing dozens or hundreds of Unity GameObjects, components, or materials one at a time is slow and error-prone, and long-running operations like compiles or tests block the Editor main thread. This Skill provides a unified query-preview-execute pipeline for bulk edits plus a job system for polling, waiting on, and cancelling asynchronous work. ## Core Features & Use Cases - Preview-then-commit bulk edits: Query objects with unified filters, preview renames, property changes, or material replacements with diffs, then commit via a one-time confirmToken. - Async job management: Poll job status and progress events, stream logs, wait with bounded timeouts, cancel jobs, and retry only failed items from a prior report. - Multi-skill batching: Compose up to 50 different skill calls into one HTTP request with dryRun, transactional rollback, and inter-step $ref references. - Use Case: Rename 200 scene objects to a standardized naming convention by previewing the change with batch_preview_rename, reviewing the sample diff, executing with batch_execute, and polling the returned jobId until completion. ## Quick Start Preview renaming all GameObjects matching a query filter, then execute the confirmed batch and poll the resulting job until it completes.

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?▼

Call batch_preview_rename with a queryJson filter and a mode such as prefix, suffix, replace, or regex_replace to see a diff first. Then pass the returned confirmToken to batch_execute to commit the change, optionally as an async job.

How do I run multiple Unity skill calls in one request?▼

Use the POST /skills/batch HTTP endpoint with up to 50 steps, each containing a skill name and args. It supports dryRun validation, transactional all-or-nothing mode with Undo rollback, and $ref references between steps.

How do I poll a long-running Unity job without blocking the Editor?▼

Poll GET /jobs/{id} every 200-500ms, which runs in the light lane instead of the main-thread skill queue. For continuous responsiveness during long jobs, use the GET /events long-poll endpoint instead of job_wait.

Why does job_wait return immediately for compile or test jobs?▼

Compile, package, test, playmode, and build jobs depend on Unity's own engine loop, which needs the main thread free to advance. job_wait detects these kinds and returns the current snapshot with waitNotSupported: true instead of blocking.

What is the difference between batch_execute and POST /skills/batch?▼

batch_execute commits one previewed bulk operation over many objects using a confirmToken from a batch_preview_* skill. POST /skills/batch composes many different skills in one HTTP call and takes no token; they are not interchangeable.

Can I retry only the failed items from a batch operation?▼

Yes, call batch_retry_failed with the reportId from the original execution report. It re-runs only the failed items and returns a new jobId plus the originalReportId for tracking.

Related Skills

Explore More Software Engineering Skills→
muddyrainmuddyrain
1

unity-component

Add, remove, and configure components on Unity GameObjects.

Community
Advanced
PMK95PMK95

tests-run

Execute Unity EditMode or PlayMode tests and return per-test results with filters.

Community
Intermediate
du-qwqdu-qwq

unity-workflow

Tracks Unity editor operations with snapshots, bookmarks, and task or session-level undo.

Community
Advanced
Unity-UPM-PackagesUnity-UPM-Packages

dev-editor-scripting

Automates Unity Editor tasks with MenuItem tools, Custom Inspectors, and AssetPostprocessor hooks.

Official
Intermediate