unity-yooasset

Automate YooAsset bundle builds, collector configuration, and build report analysis in Unity Editor.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing YooAsset hot-update pipelines in Unity involves repetitive Editor work: configuring Collector packages and rules, running bundle builds, parsing BuildReport files, and validating runtime behavior in PlayMode. This Skill automates those Editor-side tasks through a consistent set of API-backed operations. ## Core Features & Use Cases - Bundle Build & Simulation: Run ScriptableBuildPipeline or RawFileBuildPipeline builds, or fast EditorSimulateMode simulate builds with no file I/O. - Collector Configuration CRUD: Create and modify Collector packages, groups, and collectors with validated rule class names, then persist the AssetBundleCollectorSetting asset. - BuildReport Analysis: Load .report files to list bundles and assets, inspect dependency graphs, compare two reports, and find unreferenced assets. - Runtime Validation: Launch async PlayMode jobs that initialize EditorSimulateMode, test asset loads and downloader status, and poll results. - Use Case: A developer says "打AB包" — the Skill checks the YooAsset installation, configures collectors for Assets/GameRes/UI, runs a simulate build, then a real LZ4-compressed build, and analyzes the resulting report for oversized bundles. ## Quick Start Ask the AI to check the YooAsset installation, configure a Collector package for your UI assets, build bundles with the ScriptableBuildPipeline, and summarize the largest bundles from the build report.

Frequently Asked Questions about unity-yooasset

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

FAQPage Schema
How do I build YooAsset bundles from the Unity Editor?

Call yooasset_build_bundles with a packageName, packageVersion, and pipeline such as ScriptableBuildPipeline. It writes output to <projectPath>/Bundles/<PackageName>/<Version> and supports options like LZ4 compression, HashName file style, and build cache clearing.

How do I configure YooAsset Collector packages and groups?

Use yooasset_create_collector_package, yooasset_create_collector_group, and yooasset_add_collector with rule class names discovered via yooasset_list_collector_rules. Finish with yooasset_save_collector_config to persist the AssetBundleCollectorSetting asset.

Which YooAsset versions are supported?

The module targets YooAsset 2.3.18 and requires a minimum of 2.3.15, enforced by an asmdef versionDefines entry. Earlier versions use an incompatible manifest format and will not compile against this module.

Why do YooAsset skills return a NoYooAsset error?

Every skill except yooasset_check_installed requires the YOO_ASSET compile define, which only exists when the com.tuyoogame.yooasset package is installed. Install or upgrade the package, let Unity recompile, then retry.

How do I analyze a YooAsset BuildReport file?

Load the .report file with yooasset_load_build_report, then list bundles and assets, inspect dependency graphs, compare two reports, or find unreferenced assets. The .report file sits next to the bundles, not the .json manifest.

Can I validate YooAsset assets at runtime without a real build?

Yes, yooasset_runtime_validate_package starts an async PlayMode job using EditorSimulateMode that initializes the package, optionally loads and releases one asset, and checks downloader status. Poll results with yooasset_runtime_get_validation_result.