SkillAgentSearch skills...

unity-yooasset

Automate YooAsset hot-update and asset bundles

Install / Use

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

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

84/100

Category

Automation

Supported Platforms

Universal

Tags

Our assessment of unity-yooasset

unity-yooasset scores 84/100 on our quality scale, 2070th of 2,790 Automation skills we index.

Its SKILL.md is 18 KB long, well organised into 22 sections with 1 code example: 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
17/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-yooasset is actively maintained.
  • Our last check on 2026-10-14 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-yooasset compared with similar skills

All 4 of these similar skills score higher than unity-yooasset; compare them before choosing.

SkillScoreStarsUpdatedFormat
unity-yooasset (this skill)by Besty0728841.8k53d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server

Frequently asked questions

How do I install unity-yooasset?
Run npx skills add Besty0728/Unity-Skills --skill unity-yooasset. The install tabs above show the steps for each supported agent.
Which AI agents does unity-yooasset 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-yooasset 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-yooasset still maintained?
The repository was last updated about 2 months ago, so unity-yooasset is actively maintained.

name: unity-yooasset description: Automate YooAsset hot-update and asset bundles

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

  • Building or simulating YooAsset bundles
  • Configuring collectors
  • Validating hot-update assets
  • 构建或模拟 YooAsset 资源包、配置 collector、校验热更资源

Unity YooAsset Skills

Editor-side automation for the YooAsset hot-update framework — build pipeline orchestration, Collector configuration CRUD, BuildReport analysis, PlayMode runtime validation, and companion YooAsset tools. Every skill wraps a concrete YooAsset Editor/runtime API path validated against 2.3.18 source. When the package is absent, every skill except yooasset_check_installed returns a NoYooAsset() error with install instructions.

Requires: com.tuyoogame.yooasset ≥ 2.3.15, Unity 2022.3+ (validated against 2.3.18). Strongly recommended: before writing ANY YooAsset runtime code, load yooasset-design. PlayMode / parameter-class / handle-lifecycle pitfalls are strict, and only the advisory module surfaces them.

Guardrails

Operating Mode (v1.9 three-tier):

  • Approval (default): query/list/read skills (yooasset_check_installed, yooasset_get_default_paths, yooasset_get_build_settings, yooasset_list_collector_packages, yooasset_list_collector_rules, yooasset_list_assetart_scanners, yooasset_runtime_get_validation_result, yooasset_load_build_report, yooasset_list_report_bundles, yooasset_get_bundle_detail, yooasset_list_report_assets, yooasset_get_asset_detail, yooasset_get_dependency_graph, yooasset_compare_build_reports, yooasset_list_independ_assets) run directly. Builders / Collector mutators / scanner runs / window-openers are FullAuto — on MODE_RESTRICTED, run the grant protocol.

  • Auto / Bypass: SemiAuto and FullAuto run directly.

  • Auto-forbidden in this module:

    • MayEnterPlayMode = true → yooasset_runtime_validate_package, yooasset_runtime_cleanup
    • SkillOperation.Delete → yooasset_remove_collector_package, yooasset_remove_collector_group, yooasset_remove_collector

    Reachable only under Bypass mode or via a user-managed Allowlist entry; the grant flow returns MODE_FORBIDDEN. Note yooasset_build_bundles runs heavy disk I/O but has no Reload/PlayMode flag, so it stays grantable.

  • When com.tuyoogame.yooasset is missing, every skill except yooasset_check_installed returns a NoYooAsset() error with install instructions.

DO NOT (common hallucinations):

  • yooasset_initialize / yooasset_load_asset / yooasset_create_downloader — do NOT exist as general-purpose REST skills. Runtime APIs (YooAssets.Initialize, default-package YooAssets.LoadAssetAsync, ResourcePackage.LoadAssetAsync, RequestPackageVersionAsync, CreateResourceDownloader) belong in game code. Use yooasset-design when writing runtime code.
  • yooasset_modify_group / yooasset_delete_collector / yooasset_open_scanner_window — wrong names. Use the exact schema names below or query GET /skills/schema?category=YooAsset.
  • yooasset_install — NOT a skill. Package install is a Package Manager user action.
  • Do NOT pass timeout to yooasset_build_bundles — the property was removed in YooAsset 2.3.16. Runtime watchdog now lives on CacheFileSystemParameters.DOWNLOAD_WATCH_DOG_TIME (runtime concern, not a build parameter).
  • Do NOT call yooasset_build_bundles while EditorUserBuildSettings.isBuildingPlayer == true — BuildParameters.CheckBuildParameters throws.

Routing:

  • Collector configuration (packages, groups, collectors, rules) → this module.
  • Actual bundle build + simulate + paths → this module.
  • Build report analysis (bundle size, asset list/detail, dependency graph, report compare, orphan) → this module.
  • Runtime validation in Editor PlayMode → yooasset_runtime_validate_package + polling/cleanup skills in this module.
  • Runtime code generation/design (Initialize / Load / Download / Scene in game scripts) → write it yourself using yooasset-design.
  • YooAsset companion windows and AssetArtScanner config/runs → this module.
  • Version-policy decisions (2.x vs pre-2.3.15 manifest, FindAssetType on IFilterRule) → yooasset-design/PITFALLS.md.

Skills

Environment (1)

| Skill | Purpose | Key Parameters | |-------|---------|----------------| | yooasset_check_installed | Reflection probe — works even when the package is missing. Reports runtime assembly, package version, editor availability, and which of the 4 pipelines are present. | (none) |

Build pipeline (7)

| Skill | Purpose | Key Parameters | |-------|---------|----------------| | yooasset_build_bundles | Build bundles via ScriptableBuildPipeline or RawFileBuildPipeline. Writes to <projectPath>/Bundles/<PackageName>/<Version>. | packageName, packageVersion="auto", pipeline="ScriptableBuildPipeline", buildTarget?, compression="LZ4", fileNameStyle="HashName", clearBuildCache=false, useAssetDependencyDB=true, verifyBuildingResult=true, replaceAssetPathWithAddress=false, stripUnityVersion=false, disableWriteTypeTree=false, trackSpriteAtlasDependencies=false, writeLinkXML=true, cacheServerHost="", cacheServerPort=0, builtinShadersBundleName="", monoScriptsBundleName="", includePathInHash=false, buildinFileCopyOption="None", buildinFileCopyParams="", enableLog=true | | yooasset_simulate_build | Run AssetBundleSimulateBuilder.SimulateBuild for an EditorSimulateMode package — virtual bundles only, no files written. | packageName | | yooasset_get_default_paths | Return BuildOutputRoot + StreamingAssetsRoot that YooAsset uses. | (none) | | yooasset_get_build_settings | Read persisted YooAsset AssetBundle Builder EditorPrefs for a package/pipeline. | packageName, pipeline? | | yooasset_set_build_settings | Persist AssetBundle Builder EditorPrefs for repeatable build UI defaults. | packageName, pipeline?, compression?, fileNameStyle?, buildinFileCopyOption?, buildinFileCopyParams?, encryptionServicesClassName?, manifestProcessServicesClassName?, manifestRestoreServicesClassName?, clearBuildCache?, useAssetDependencyDB? | | yooasset_open_builder_window | Open the YooAsset AssetBundle Builder Editor window. | (none) | | yooasset_open_collector_window | Open the YooAsset AssetBundle Collector Editor window. | (none) |

YooAsset tools (8)

| Skill | Purpose | Key Parameters | |-------|---------|----------------| | yooasset_open_reporter_window | Open the YooAsset AssetBundle Reporter window. | (none) | | yooasset_open_debugger_window | Open the YooAsset AssetBundle Debugger window. | (none) | | yooasset_open_assetart_scanner_window | Open the YooAsset AssetArt Scanner window. | (none) | | yooasset_list_assetart_scanners | List AssetArtScanner configurations, optionally filtered by keyword. | keyword? | | yooasset_run_assetart_scanner | Run one scanner and optionally save its report file. | scannerGUID, saveDirectory? | | yooasset_run_all_assetart_scanners | Run all scanners, optionally filtered by keyword. | keyword? | | yooasset_import_assetart_scanner_config | Import AssetArtScanner JSON config. | configPath | | yooasset_export_assetart_scanner_config | Export AssetArtScanner JSON config. | configPath |

Runtime validation (3)

| Skill | Purpose | Key Parameters | |-------|---------|----------------| | yooasset_runtime_validate_package | Start an async PlayMode job that initializes EditorSimulateMode, sets default package, optionally validates one asset load/release and downloader status, then optionally cleans up and returns to Edit Mode. | packageName, assetLocation?, restoreEditMode=true, cleanup=true, checkDownloader=true, downloadingMaxNumber=4, failedTryAgain=1 | | yooasset_runtime_get_validation_result | Poll the runtime validation job status/result. | jobId | | yooasset_runtime_cleanup | Remove completed validation jobs and optionally force YooAssets.Destroy() / exit PlayMode. | jobId?, forceYooAssetsDestroy=false, exitPlayMode=false |

Collector configuration (13)

| Skill | Purpose | Key Parameters | |-------|---------|----------------| | yooasset_list_collector_packages | List Packages → Groups → Collectors tree. verbose=true returns the full descent. | verbose=false | | yooasset_list_collector_rules | Return registered Active / Address / Pack / Filter / Ignore rule classes. | ruleKind="all" (or activeRule|addressRule|packRule|filterRule|ignoreRule) | | yooasset_create_collector_package | Create a new Collector Package. Fails on duplicate unless allowDuplicate=true. | packageName, allowDuplicate=false | | yooasset_create_collector_group | Create a Group inside an existing Package. | packageName, groupName, groupDesc="", activeRule="EnableGroup", assetTags="" | | yooasset_add_collector | Add an AssetBundleCollector to a Group. Validates collectPath via AssetDatabase and each rule via its registered class name. | packageName, groupName, collectPath, collectorType="MainAssetCollector", addressRule="AddressByFileName", packRule="PackDirectory", filterRule="CollectAll", assetTags="", userData="" | | yooasset_save_collector_config | Persist the AssetBundleCollectorSetting.asset. Optionally run FixFile() to repair dangling rule references. | fixErrors=true | | yooasset_modify_collector_settings | Modify global Collector settings. | showPackageView=false, uniqueBundleName=false, save=true | | yooasset_modify_collector_package | Rename/describe a package and set package-level options. | packageName, packageDesc?, newPackageName?, enableAddressable=false, supportExtensionless=true, locationToLower=false, includeAssetGUID=false, autoCollectShaders=true, ignoreRule="NormalIgnoreRule", save=true | | yooasset_remove_collector_package | Remove a Collector package by name. | packageName, save=true | | yooasset_modify_collector_group | Rename/describe a group and update active rule/tags. | packageName, groupName, newGroupName?, groupDesc?, activeRule="EnableGroup", assetTags?, save=true | | yooasset_remove_collector_group | Remove a group from a package. | packageName, groupName, save=true | | yooasset_modify_collector | Modify an existing collector matched by collectPath. | packageName, groupName, collectPath, newCollectPath?, collectorType="MainAssetCollector", addressRule="AddressByFileName", packRule="PackDirectory", filterRule="CollectAll", assetTags?, userData?, save=true | | yooasset_remove_collector | Remove a collector matched by collectPath. | packageName, groupName, collectPath, save=true |

Build report analysis (8)

| Skill | Purpose | Key Parameters | |-------|---------|----------------| | yooasset_load_build_report | Deserialize a YooAsset BuildReport .report file and return ReportSummary metadata + top-level totals. | reportPath | | yooasset_list_report_bundles | Paginated / filtered / sorted bundle listing from the report. | reportPath, filterEncrypted?, filterTag?, sortBy="size" (size|name|refCount|dependCount), limit=100, offset=0 | | yooasset_get_bundle_detail | Full ReportBundleInfo for a single bundle — DependBundles, ReferenceBundles, asset BundleContents. | reportPath, bundleName | | yooasset_list_report_assets | Paginated / filtered / sorted asset listing from the report. | reportPath, filterBundle?, filterTag?,

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars1.8k
CategoryAutomation
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