| 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.
