skills.rest
pcone-mm
pcone-mmCOMMUNITY
Explore all skills by this author →
GitHub

unity-batch

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

2|Updated May 18, 2026
Search Tags:#unity#batch operations#bulk edit#gameobjects#async jobs#scene automation#preview confirm
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-batch-pcone-mm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-batch
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/batch
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-batch-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applying the same change to dozens or hundreds of Unity GameObjects, components, or assets by hand is slow and error-prone, and long-running operations can block the editor. This Skill provides a unified batch workflow: query targets, preview the exact changes, confirm with a token, execute as a background job, and poll progress until completion. ## Core Features & Use Cases - Batch Queries: Filter GameObjects, components, and assets by name, path, tag, layer, type, or label with batch_query_gameobjects, batch_query_components, and batch_query_assets. - Preview-Confirm-Execute Mutations: Preview renames, property changes, material replacements, layer assignments, and cleanup operations, review the sample and risk fields, then commit with batch_execute(confirmToken). - Async Job Management: Schedule long operations as background jobs and monitor them with job_status, job_progress, job_logs, job_wait, and job_cancel; retry only failed items via batch_retry_failed. - Use Case: Rename 200 scene objects with a consistent prefix: preview the rename with batch_preview_rename, inspect the sample output, execute with the returned confirmToken, then poll job_status until the job finishes and review the report with batch_report_get. ## Quick Start Ask the AI to preview renaming all GameObjects tagged "Enemy" with the prefix "Boss_", review the preview sample, then confirm execution 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. Review the returned sample, then pass the confirmToken to batch_execute to apply the rename, optionally as an async job.

How do I run a bulk edit on many Unity objects at once?▼

Use the preview-confirm-execute pattern: run a batch_preview_* skill to see affected objects and risk fields, then call batch_execute with the returned confirmToken. Large operations return a jobId you can poll with job_status.

Why does batch_execute fail when called directly?▼

batch_execute requires a confirmToken produced by a prior batch_preview_* call; it cannot run standalone. Tokens are single-use and expire, so you must re-run the preview if the token is consumed or stale.

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

job_wait blocks the Unity main thread and is clamped to 2 seconds, but compile, package, test, playmode, and build jobs need the main thread free to advance. For those kinds it returns waitNotSupported: true; poll job_status or the HTTP /jobs endpoint instead.

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

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

What are the limitations of the Unity batch module?▼

It does not handle asset-level move, copy, or delete operations, which belong to the asset module, and it has no batch_run, job_poll, or batch_delete skills. High-impact changes still require reviewing preview sample and risk fields before confirming.

Related Skills

Explore More Software Engineering Skills→
AdielMagAdielMag

gameobject-find

Finds a GameObject in the opened Unity Prefab or active Scene with optional data, components, bounds, and hierarchy.

Community
Intermediate
YiDuandtdtYiDuandtdt

unity-batch

Executes tracked batch edits on Unity Engine objects, layers, and files with rollback-ready previews and reports.

Community
Advanced
Stardust-liuStardust-liu
1

unity-validation

Validate Unity project scenes and references for missing scripts and broken links.

Community
Intermediate
Unity-UPM-PackagesUnity-UPM-Packages

dev-editor-scripting

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

Official
Intermediate