worktree-setup

name

worktree-setup

description

Use this skill FIRST, before anything else, whenever work is about to happen in a brand-new VRCQuestTools checkout — right after `git clone` or `git worktree add`, or when the user mentions a fresh/new worktree, clone, or checkout and wants to launch Unity, run EditMode/PlayMode tests, or build there. A fresh checkout is always missing untracked dependencies; this skill performs the two mandatory setup steps (resolve VPM packages, download astcenc binaries). Also use when a fresh checkout misbehaves in ways that indicate skipped setup: Unity won't open the project or spams missing-package errors in the console, compilation fails with "type or namespace could not be found" for VRC/VRCSDK/NDMF, Packages/com.vrchat.base doesn't exist, or all astcenc tests are skipped. Do not use for upgrading package versions, packages-lock.json questions, CI workflow tuning, or explaining how git worktrees work.

New Worktree / Clone Setup

A fresh working copy of VRCQuestTools needs two setup steps before Unity work can start.

1. Resolve VPM packages (required before launching Unity)

Some packages under Packages/ (e.g. com.vrchat.avatars, com.vrchat.base) are VPM dependencies resolved into the working copy and are not tracked in git — a fresh worktree starts without them. Check whether Packages/com.vrchat.base exists; if it's missing, run vrc-get resolve (see the vrc-get skill) to install all VPM dependencies before launching Unity with uloop-launch. Launching Unity first can cause it to fail or generate broken package state.

2. Download astcenc binaries (once per clone/worktree)

The astcenc CLI binaries used for fast ASTC texture compression are not committed to the repository; download them once per clone/worktree:

Command	Description
bash scripts/download-astcenc.sh	Download astcenc binaries (Windows + Linux) on Linux/macOS/Git Bash
pwsh scripts/download-astcenc.ps1	Download astcenc binaries (Windows + Linux) on Windows

Both accept --platform windows|linux|all (default all) and are idempotent (re-running when the binaries already match the recorded SHA256 is a no-op). If this step is skipped, VRCQuestTools still works — texture compression automatically falls back to Unity's built-in compressor — but the astcenc code path is not exercised and its tests are skipped.