unity-hybridclr
Automate HybridCLR C# hot-update prebuild
Install / Use
npx skills add Besty0728/Unity-Skills --skill hybridclrInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of unity-hybridclr
unity-hybridclr scores 85/100 on our quality scale, 1939th of 2,790 Automation skills we index.
Its SKILL.md is 21 KB long, well organised into 21 sections with 2 code examples: 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.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so unity-hybridclr is actively maintained.
- Our last check on 2026-11-04 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 foundOur 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-hybridclr compared with similar skills
All 4 of these similar skills score higher than unity-hybridclr; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unity-hybridclr (this skill)by Besty0728 | 85 | 1.8k | 53d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install unity-hybridclr?
- Run
npx skills add Besty0728/Unity-Skills --skill unity-hybridclr. The install tabs above show the steps for each supported agent. - Which AI agents does unity-hybridclr 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-hybridclr 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-hybridclr still maintained?
- The repository was last updated about 2 months ago, so unity-hybridclr is actively maintained.
Skill content
View source on GitHubname: unity-hybridclr description: Automate HybridCLR C# hot-update prebuild
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
- Configuring hot-update assemblies
- Compiling hot-update DLLs
- Generating AOTGenericReferences/link.xml
- Diagnosing HybridCLR setup
- Wiring output into YooAsset builds
- 配置热更程序集、编译热更 DLL、生成 AOTGenericReferences/link.xml、排查 HybridCLR 环境、把产物接进 YooAsset 打包链路
Unity HybridCLR Skills
Editor-side automation for HybridCLR — the zero-cost native C# hot-update solution for IL2CPP. Covers settings CRUD, installation probing, hot-update assembly compilation, the prebuild generation pipeline, and artifact staging for a YooAsset bundle build.
This module holds zero direct references to the package. Every call resolves through reflection against the HybridCLR.Editor assembly, so the UnitySkills Editor assembly compiles identically whether or not HybridCLR is installed — there is no scripting define to set and no recompile needed after installing.
Requires:
com.code-philosophy.hybridclr(API anchored to 8.12.0), IL2CPP scripting backend, Unity 2019.4+ (2022.3+ recommended). Companion modules: yooasset for shipping the compiled DLLs as bundles, yooasset-design for the runtime loading contract, asmdef for assembly-boundary design.
Guardrails
Operating Mode (v1.9 three-tier):
- Approval (default): the seven read-only skills —
hybridclr_status,hybridclr_install_status,hybridclr_get_paths,hybridclr_settings_get,hybridclr_validate_setup,hybridclr_get_hotupdate_dlls,hybridclr_aot_generic_refs— areSemiAutoand run directly.hybridclr_settings_setandhybridclr_copy_hotupdate_dllsare FullAuto: onMODE_RESTRICTED, run the grant protocol. - Auto-forbidden (NeverInSemi,
RiskLevel="high"):hybridclr_compile_dlls,hybridclr_generate_all,hybridclr_generate_step. Reachable only under Bypass mode or via a user-managed Allowlist entry; the grant flow returnsMODE_FORBIDDEN. This is deliberate — all three block the Editor main thread for minutes. - When the package is missing, every skill except
hybridclr_statusreturns aMISSING_PACKAGEerror with install instructions. When the package is present but a reflected member cannot be resolved (version drift), the skill returnsMISSING_PACKAGEnaming the exact member instead of throwing.
DO NOT (common hallucinations):
hybridclr_install/hybridclr_init— do NOT exist. Installing il2cpp_plus clones two git repos and copies the entire editor il2cpp tree; it is a multi-minute network operation with no cancellation and is intentionally not a skill. Run it from HybridCLR/Installer... in the Editor, or via unity-cli (see Limitations).hybridclr_install_statusonly reports the state.hybridclr_build_player— NOT in this module. Building the player isbuild_player(Project module) or unity-cli. HybridCLR hooks the build via its ownIPreprocessBuildWithReportprocessors; nothing extra is needed from this module.hybridclr_load_metadata/hybridclr_load_assembly— runtime APIs (HybridCLR.RuntimeApi.LoadMetadataForAOTAssembly,System.Reflection.Assembly.Load) belong in game code, not the Editor REST surface. Write them yourself.- Do NOT call
hybridclr_generate_allbefore every bundle rebuild — see the workflow section below. It is a pre-player-build step, not a per-hot-update step. - Do NOT pass
extension=".dll"tohybridclr_copy_hotupdate_dlls. Unity would treat the staged files as managed plugins and try to load them into the Editor domain; the skill rejects it.
Routing:
- HybridCLR settings, install probing, DLL compilation, generation pipeline, artifact staging → this module.
- Packing the staged DLLs into bundles, collector configuration, build reports → yooasset.
- Runtime hot-update loading code (
YooAssets.LoadAssetAsync→Assembly.Load→RuntimeApi.LoadMetadataForAOTAssembly) → write it yourself using yooasset-design. - Deciding which assemblies belong on the hot-update side → asmdef.
- Actual player build →
build_playeror unity-cli.
Skills
Environment (3)
| Skill | Purpose | Key Parameters |
|-------|---------|----------------|
| hybridclr_status | Reflection probe — the ONLY skill that works without the package. Reports installation, package version, enable, scripting backend, hot-update + AOT-patch assembly lists, and which generated artifacts exist. Call this first. | (none) |
| hybridclr_install_status | il2cpp_plus local install state via InstallerController: whether libil2cpp is patched, installed vs package version, expected hybridclr / il2cpp_plus branches, Unity compatibility. | (none) |
| hybridclr_get_paths | Resolve every input/output path for a build target — HybridCLRData root, local il2cpp dir, hot-update DLL dir, stripped AOT dir, link.xml, AOTGenericReferences.cs. Use to wire outputs into a YooAsset collector. | buildTarget? |
Settings (2)
| Skill | Purpose | Key Parameters |
|-------|---------|----------------|
| hybridclr_settings_get | Read every HybridCLRSettings field, plus the resolved assembly lists SettingsUtil derives from asmdef assets and raw names (this is what the pipeline actually uses). | (none) |
| hybridclr_settings_set | Write settings and persist to ProjectSettings/HybridCLRSettings.asset. Only the parameters you pass change; the full prior object is snapshotted for workflow undo. | enable?, useGlobalIl2cpp?, hotUpdateAssemblies?, hotUpdateAssemblyDefinitions?, preserveHotUpdateAssemblies?, patchAOTAssemblies?, externalHotUpdateAssemblyDirs?, hotUpdateDllCompileOutputRootDir?, strippedAOTDllOutputRootDir?, outputLinkFile?, outputAOTGenericReferenceFile?, maxGenericReferenceIteration?, maxMethodBridgeGenericIteration?, hybridclrRepoURL?, il2cppPlusRepoURL? |
Diagnostics (1)
| Skill | Purpose | Key Parameters |
|-------|---------|----------------|
| hybridclr_validate_setup | Pre-flight check: package present, enable, IL2CPP backend, libil2cpp patched and version-matched, hot-update assemblies configured and resolvable, patchAOTAssemblies populated, link.xml / AOTGenericReferences.cs present, hot-update DLLs compiled. Returns categorised errors (blocking) and warnings (advisory), each with a concrete fix. | buildTarget? |
Compile & generate (3) — blocking, high risk
| Skill | Purpose | Key Parameters |
|-------|---------|----------------|
| hybridclr_compile_dlls | CompileDllCommand.CompileDll(target, developmentBuild) — compile hot-update assemblies into HybridCLRData/HotUpdateDlls/<target>. Prior output is backed up for workflow undo. | buildTarget?, developmentBuild=false |
| hybridclr_generate_all | PrebuildCommand.GenerateAll() — the full pipeline for the active build target: compile_dll → il2cpp_def → link_xml → aot_dlls → method_bridge → aot_generic_reference. Rewrites C# under Assets/, so a domain reload follows. | (none) |
| hybridclr_generate_step | Run one pipeline step: il2cpp_def, link_xml, aot_dlls, method_bridge, aot_generic_reference, clean_il2cpp_cache. Assumes hot-update DLLs are already compiled. | step, buildTarget? |
Artifacts (3)
| Skill | Purpose | Key Parameters |
|-------|---------|----------------|
| hybridclr_get_hotupdate_dlls | List compiled DLL artifacts with size + UTC timestamp, reconciled against the configured assembly list — surfaces missing and unexpected entries. | buildTarget? |
| hybridclr_copy_hotupdate_dlls | Stage compiled DLLs (optionally the stripped AOT DLLs too) into a directory under Assets/, renamed to an importable extension so a YooAsset collector can pack them. Destination files are backed up for workflow undo. | destination, buildTarget?, extension=".bytes", assemblies?, includeAotAssemblies=false, clearDestination=false |
| hybridclr_aot_generic_refs | Read generated AOTGenericReferences.cs — timestamp, declared PatchedAOTAssemblyList, and an inSync comparison against settings.patchAOTAssemblies with missingFromSettings / extraInSettings diffs. | includeContent=false |
HybridCLR × YooAsset workflow
The two modules split cleanly: HybridCLR produces DLLs, YooAsset ships them. The staging step in between is hybridclr_copy_hotupdate_dlls, which renames .dll → .bytes so Unity imports them as TextAsset (a bare .dll under Assets/ would be treated as a managed plugin).
One-time setup (per project, and again after any AOT-side code change):
u.call_skill("hybridclr_settings_set",
enable=True,
hotUpdateAssemblyDefinitions=["Assets/HotUpdate/HotUpdate.asmdef"])
u.call_skill("hybridclr_validate_setup") # fix every `errors` entry before continuing
u.call_skill("hybridclr_generate_all") # minutes; domain reload follows
refs = u.call_skill("hybridclr_aot_generic_refs")
u.call_skill("hybridclr_settings_set", patchAOTAssemblies=refs["patchedAOTAssemblyList"])
# then build the player normally (build_player / unity-cli)
Iterative hot-update loop (every time hot-update C# changes — no generate_all, no player rebuild):
# 1. edit hot-update C# (script_* skills) — must live in a hotUpdateAssemblyDefinitions asmdef
# 2. compile
u.call_skill("hybridclr_compile_dlls", buildTarget="Android")
u.call_skill("hybridclr_get_hotupdate_dlls", buildTarget="Android") # verify `missing` is empty
# 3. stage into the YooAsset collector directory
u.call_skill("hybridclr_copy_hotupdate_dlls",
destination="Assets/HotUpdateDlls",
buildTarget="Android",
extension=".bytes",
includeAotAssemblies=True, # ships the stripped AOT metadata DLLs too
clearDestination=True)
# 4. pack (yooasset module) — the collector only needs adding once
u.call_skill("yooasset_add_collector",
packageName="DefaultPackage", groupName="HotUpdateCode",
collectPath="Assets/HotUpdateDlls",
addressRule="AddressByFileName", packRule="PackDirectory")
u.call_skill("yooasset_build_bundles",
packageName="DefaultPackage", buildTarget="Android", packageVersion="auto")
Where the boundary sits: runtime loading is game code you write, not a skill. Load the .bytes TextAsset through YooAsset, then RuntimeApi.LoadMetadataForAOTAssembly(aotBytes, HomologousImageMode.SuperSet) for each AOT metadata DLL before Assembly.Load(hotUpdateBytes). Order matters. See yooasset-design for the handle-lifecycle rules.
When to re-run generate_all: only when AOT-side code changes (anything outside the hot-update asmdefs), when you add/remove a hot-update assembly, or before shipping a new player build. Generic instantiations reachable only from new hot-update code also require it — that is what AOTGenericReferences.cs records.
Critical Rules (must read)
hybridclr_statusis the only skill that works without the package. Every other skill returnsMISSING_PACKAGE. Unlike the YooAsset module there is no compile define — detection is pure reflection, so no recompile is needed after installing.hybridclr_compile_dlls,hybridclr_generate_allandhybridclr_generate_stepblock the Editor main thread. UnitySkills runs all skills on the main thread through a single queue, so/healthand/jobsalso stall for the duration. Raise the client timeout to at least 10 minutes; a socket timeout does **not
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
