Agent skill

Viewsystem Pool Migration

by MacacaGames in MacacaGames/MacacaViewSystem

Migrate MacacaViewSystem ViewElement pools from KeepForever to an evidence-based recovery policy while preserving lifecycle, requested-pool, unique, async, event, and Addressable ownership safety.

MITAuto-check passedGame Development

Install Viewsystem Pool Migration

skills CLI
$ npx skills add MacacaGames/MacacaViewSystem --skill viewsystem-pool-migration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MacacaGames/MacacaViewSystem viewsystem-pool-migration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MacacaGames/MacacaViewSystem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/viewsystem-pool-migration .claude/skills/viewsystem-pool-migration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
viewsystem-pool-migration
GitHub stars
121
Token cost
~1.3k tokens
SKILL.md length
603 words
Files
3 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Migrate MacacaViewSystem ViewElement pools from KeepForever to an evidence-based recovery policy while preserving lifecycle, requested-pool, unique, async, event, and Addressable ownership safety.

  • Works in 5 steps: Locate the package root by finding the… → Locate the Unity host root containing… → Read completely before editing → …
  • Analyzing a ViewSystem Pool Policy Advisor
  • SKILL.md covers Establish context, Interpret evidence correctly, Choose one candidate and Audit the ownership boundary, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Viewsystem Pool Migration is an agent skill from MacacaGames/MacacaViewSystem. Migrate MacacaViewSystem ViewElement pools from KeepForever to an evidence-based recovery policy while preserving lifecycle, requested-pool, unique, async, event, and Addressable ownership safety. Use when analyzing a ViewSystem Pool Policy Advisor or Object Graph JSON report, selecting a migration candidate, implementing ViewElementLifetimeScope or owner-aware requested pools, applying KeepN or DestroyOnRecovery, or validating reopen and recovery behavior in a Unity host project.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/report-contract.md`).

It sits in Game Development. It works with Unity. The repository describes itself as: ViewSystem is a element based UI management system based on Unity GUI. The licence is MIT.

When your agent uses it

  • Analyzing a ViewSystem Pool Policy Advisor
  • Object Graph JSON report
  • Selecting a migration candidate
  • Implementing ViewElementLifetimeScope

Example prompts

  • “/viewsystem-pool-migration”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Locate the package root by finding the ancestor containing package.json and Runtime/Components/ViewElement.cs.
  2. Locate the Unity host root containing Assets/ and ProjectSettings/.
  3. Read completely before editing
  4. Inspect dirty worktrees in both the host and package repositories. Preserve unrelated changes.
  5. Read references/report-contract.md before interpreting or producing Advisor artifacts.

What it can do on your machine

Read from SKILL.md and the folder at commit af8e002. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Viewsystem Pool Migration loads about 1.3k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 128 tokens; SKILL.md has 603 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~128
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MacacaGames/MacacaViewSystem at commit af8e002, republished under its MIT licence (© MacacaGames). 603 words, ~1,320 tokens.

Download SKILL.mdSave it as .claude/skills/viewsystem-pool-migration/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
viewsystem-pool-migration
description
Migrate MacacaViewSystem ViewElement pools from KeepForever to an evidence-based recovery policy while preserving lifecycle, requested-pool, unique, async, event, and Addressable ownership safety. Use when analyzing a ViewSystem Pool Policy Advisor or Object Graph JSON report, selecting a migration candidate, implementing ViewElementLifetimeScope or owner-aware requested pools, applying KeepN or DestroyOnRecovery, or validating reopen and recovery behavior in a Unity host project.

ViewSystem Pool Migration

Use Unity-generated evidence to migrate one ViewElement candidate at a time. Treat the Advisor as a measurement source; inspect and change host-project code when static analysis cannot prove ownership.

Establish context

  1. Locate the package root by finding the ancestor containing package.json and Runtime/Components/ViewElement.cs.
  2. Locate the Unity host root containing Assets/ and ProjectSettings/.
  3. Read completely before editing:
    • host AGENTS.md, when present;
    • package CLAUDE.md;
    • package VIEW_ELEMENT_POOL_POLICY_DESIGN.md;
    • package VIEW_ELEMENT_POOL_POLICY_CASE_STUDY.md.
  4. Inspect dirty worktrees in both the host and package repositories. Preserve unrelated changes.
  5. Read references/report-contract.md before interpreting or producing Advisor artifacts.

Interpret evidence correctly

  • Separate the desired target policy from migration readiness. A safety warning means work is required before applying a target; it does not imply KeepForever is the desired target.
  • For schema v4 and older reports, ignore recommendedPolicy=KeepForever when it was produced only by NeedsOwnerMigration, NeedsStaticOwnership, NeedsEventCleanup, NeedsAsyncLifetime, or InsufficientRuntimeData.
  • Never recommend reverting an existing KeepN or DestroyOnRecovery migration solely because static evidence is incomplete. Classify it as NeedsRuntimeValidation or NeedsCodeReview.
  • Treat unique and singleton ownership as an architectural pin unless repository evidence explicitly proves a compatible ownership path.
  • Treat source-name runtime matches as provisional. Prefer prefab GUID and path.
  • Do not sum hierarchy GO across nested pool sources; active hierarchy counts can overlap.

Choose one candidate

Prefer a candidate with meaningful retained or active hierarchy cost, low expected use frequency, stable GUID/path evidence, and no unique/singleton pin. State why it was selected and which evidence is still missing.

Do not batch-apply DestroyOnRecovery. Do not start Addressable handle-registry work as part of a pool migration.

Audit the ownership boundary

Inspect the prefab's lifetime-owner scripts and direct requested-pool creation sites. Verify:

  • C# event subscriptions have symmetric cleanup or scope-bound registration;
  • awaited continuations use a lifetime token or a destroyed-object guard;
  • requested child pools declare ReturnToGlobalPool, DestroyWithOwner, or UseChildPolicy intentionally;
  • nested unique/singleton instances are not destroyed with an ordinary parent;
  • static callbacks and caches do not retain destroyed components;
  • Addressable ownership is unchanged by the migration.

Static regex evidence is a lead, not proof. Open the cited lines and follow the actual subscription, construction, and cleanup paths.

Show full SKILL.md (252 more words)Show less

Implement in small steps

  1. Implement required event, async, lifetime-scope, or requested-pool ownership changes first.
  2. Keep package APIs additive and host-project-agnostic.
  3. Preserve the existing unique ownership stack.
  4. Compile the affected assembly and fix new errors before changing policy.
  5. Apply serialized prefab policy only through Unity Editor API or the Inspector. Never externally edit prefab or asset YAML while Unity is open.
  6. Record the intended target in a migration plan when the Editor plan importer is available.

Do not modify FancyScrollRect or LayoutGroup conventions as a migration shortcut.

Validate runtime behavior

Capture snapshots in chronological order:

  1. stable baseline page;
  2. target open;
  3. returned stable page after recovery settles;
  4. target reopened;
  5. returned stable page again.

Require all applicable checks:

  • target active hierarchy cost is observed;
  • queued and pending instances do not grow across reopen cycles;
  • DestroyOnRecovery or KeepN reaches the intended post-return state;
  • owner-bound children do not remain in the global pool;
  • reopen content, buttons, images, and state remain correct;
  • Console has no MissingReferenceException, NullReferenceException, or duplicate callback;
  • Addressable handle ownership is unchanged.

If runtime evidence is unavailable, stop at NeedsRuntimeValidation; do not label the migration validated and do not recommend reverting it.

Report the outcome

Lead with one of these outcomes:

  • Migrated; needs runtime validation
  • Validated; keep current migrated policy
  • Blocked by concrete ownership issue
  • Pinned by unique/singleton contract
  • Insufficient evidence to choose a target policy

List changed files, compilation results, the exact remaining validation sequence, and any evidence that must be captured next.

© MacacaGames, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .agents/skills/viewsystem-pool-migration of MacacaGames/MacacaViewSystem.

  • SKILL.md
  • agents/openai.yaml
  • references/report-contract.md

Open the folder on GitHubat commit af8e002

Compare with similar skills

Viewsystem Pool Migration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Viewsystem Pool Migration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Viewsystem Pool Migration this skillMacacaGames/MacacaViewSystem121—~1.3kAutomated safety check: PassMIT
Fantasy Framework Development Guideqq362946/Fantasy1.4k—~5.8kAutomated safety check: PassCustom licence
Locus Unity BridgeMisaka-Mikoto-Tech/agent-skills275—~4kAutomated safety check: PassMIT
AibridgeFlameskyDexive/Legends-Of-Heroes929—~2.1kAutomated safety check: PassMIT
Unity SkillsBesty0728/Unity-Skills1.8k—~2kAutomated safety check: PassMIT
Uloop Control Play ModeCyberAgentGameEntertainment/NovaShader1.6k1 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Development and review guide for the Fantasy C# distributed game server framework: ECS, FTask, routing, service discovery, config and databases.

    1.4k GitHub stars~5.8k tokensUpdated 5 days ago
    Game DevelopmentAuto-check passed
  • Locus Unity Bridge

    Misaka-Mikoto-Tech/agent-skills

    A skill your agent uses when an agent needs to inspect or control a real Unity Editor through Locus, especially when Unity MCP is unavailable, named-pipe discovery is needed, C must be executed, or…

    275 GitHub stars~4k tokensUpdated 16 days ago
    Game DevelopmentAuto-check passed
  • Aibridge

    FlameskyDexive/Legends-Of-Heroes

    Unity Editor and Player Runtime CLI integration for AIBridge.

    929 GitHub stars~2.1k tokensUpdated 15 days ago
    Game DevelopmentAuto-check passed
  • Unity Skills

    Besty0728/Unity-Skills

    Automate the Unity Editor through a local REST API — scripts, scenes, prefabs, assets, materials, lighting, tests and hundreds of other Editor operations.

    1.8k GitHub stars~2k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Uloop Control Play Mode

    CyberAgentGameEntertainment/NovaShader

    Control Unity Editor Play Mode. An agent skill from CyberAgentGameEntertainment/NovaShader.

    1.6k GitHub starsUsed in 1 repo~1.3k tokens
    Game DevelopmentAuto-check passed
  • Unity Plugin

    TomLeeLive/openclaw-unity-plugin

    Control Unity Editor via OpenClaw Unity Plugin. An agent skill from TomLeeLive/openclaw-unity-plugin.

    106 GitHub stars~5.1k tokensUpdated 28 days ago
    Game DevelopmentAuto-check passed

Works with

Questions about Viewsystem Pool Migration

What does Viewsystem Pool Migration do?

Migrate MacacaViewSystem ViewElement pools from KeepForever to an evidence-based recovery policy while preserving lifecycle, requested-pool, unique, async, event, and Addressable ownership safety. Viewsystem Pool Migration is an agent skill from MacacaGames/MacacaViewSystem. Migrate MacacaViewSystem ViewElement pools from KeepForever to an evidence-based recovery policy while preserving lifecycle, requested-pool, unique, async, event, and Addressable ownership safety.

When should I use Viewsystem Pool Migration?

Viewsystem Pool Migration fits situations like: analyzing a ViewSystem Pool Policy Advisor; object Graph JSON report; selecting a migration candidate; implementing ViewElementLifetimeScope.

How do I install Viewsystem Pool Migration in Claude Code?

Run `npx skills add MacacaGames/MacacaViewSystem --skill viewsystem-pool-migration -a claude-code`. Or copy the skill folder (.agents/skills/viewsystem-pool-migration in MacacaGames/MacacaViewSystem) into .claude/skills/viewsystem-pool-migration in your project. Claude Code loads it when a task matches its description.

How do I install Viewsystem Pool Migration in Codex?

Run `npx skills add MacacaGames/MacacaViewSystem --skill viewsystem-pool-migration -a codex`. Or copy the skill folder (.agents/skills/viewsystem-pool-migration in MacacaGames/MacacaViewSystem) into .agents/skills/viewsystem-pool-migration in your project. Codex loads it when a task matches its description.

Can I use Viewsystem Pool Migration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MacacaGames/MacacaViewSystem --skill viewsystem-pool-migration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/viewsystem-pool-migration, .gemini/skills/viewsystem-pool-migration, .github/skills/viewsystem-pool-migration and .opencode/skills/viewsystem-pool-migration in your project.

What does Viewsystem Pool Migration need to run?

SKILL.md names no scripts, command-line tools or credentials: Viewsystem Pool Migration is instructions for the agent only.

Does Viewsystem Pool Migration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Viewsystem Pool Migration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Viewsystem Pool Migration use?

Viewsystem Pool Migration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Viewsystem Pool Migration use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 730 tokens, read only when the agent opens those files.

What are the alternatives to Viewsystem Pool Migration?

Skills that share tags, products or a category with Viewsystem Pool Migration: Fantasy Framework Development Guide (qq362946/Fantasy, 1.4k stars), Locus Unity Bridge (Misaka-Mikoto-Tech/agent-skills, 275 stars), Aibridge (FlameskyDexive/Legends-Of-Heroes, 929 stars) and Unity Skills (Besty0728/Unity-Skills, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Viewsystem Pool Migration?

MacacaGames (a GitHub organization) maintains it in MacacaGames/MacacaViewSystem, which has 121 GitHub stars. The repository was last updated on September 29, 2026.

Source: MacacaGames/MacacaViewSystem on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.