Agent skill

Worktree Setup

by kurotu in kurotu/VRCQuestTools

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…

MITAuto-check passedDevelopment

Install Worktree Setup

skills CLI
$ npx skills add kurotu/VRCQuestTools --skill worktree-setup -a claude-code

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

GitHub CLI
$ gh skill install kurotu/VRCQuestTools worktree-setup --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/kurotu/VRCQuestTools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/worktree-setup .claude/skills/worktree-setup && 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
worktree-setup
GitHub stars
373
Token cost
~606 tokens
SKILL.md length
191 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 2 steps: Resolve VPM packages (required before… → Download astcenc binaries (once per…
  • Mentions a fresh/new worktree
  • SKILL.md covers 1. Resolve VPM packages… and 2. Download astcenc binaries…
  • Calls bash and pwsh

What it does

Worktree Setup is an agent skill from kurotu/VRCQuestTools. 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…

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Git worktrees. It works with Git and Linux. The repository describes itself as: Unity editor extension to support uploading VRChat avatars for Oculus Quest. The licence is MIT.

When your agent uses it

  • Mentions a fresh/new worktree
  • Checkout and wants to launch Unity
  • Run EditMode/PlayMode tests
  • A fresh checkout misbehaves in ways that indicate skipped setup: Unity wont open the project

Example prompts

  • “type or namespace could not be found”
  • “/worktree-setup”

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Resolve VPM packages (required before launching Unity)
  2. Download astcenc binaries (once per clone/worktree)

What it can do on your machine

Read from SKILL.md and the folder at commit c68d147. 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

    Shell commands in SKILL.md call:

    • bash
    • pwsh

    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

Worktree Setup loads about 606 tokens when it runs. Until then it costs about 230 tokens; SKILL.md has 191 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~230
When it runs · the whole SKILL.md, loaded when a task matches
~606

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 kurotu/VRCQuestTools at commit c68d147, republished under its MIT licence (© kurotu). 191 words, ~606 tokens.

Download SKILL.mdSave it as .claude/skills/worktree-setup/SKILL.md (or your agent's skills folder).
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:

CommandDescription
bash scripts/download-astcenc.shDownload astcenc binaries (Windows + Linux) on Linux/macOS/Git Bash
pwsh scripts/download-astcenc.ps1Download 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.

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

Files

Just SKILL.md in .claude/skills/worktree-setup of kurotu/VRCQuestTools.

Open the folder on GitHubat commit c68d147

Compare with similar skills

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

Worktree Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Worktree Setup this skillkurotu/VRCQuestTools373—~606Automated safety check: PassMIT
Build Px4 macOSPX4/PX4-Autopilot13k—~1.1kAutomated safety check: PassBSD-3-Clause
WorktreeAgentsMesh/AgentsMesh2.4k—~553Automated safety check: NotesCustom licence
Git Worktree IsolationjnMetaCode/superpowers-zh8.3k1 repos~982Automated safety check: PassMIT
Cursor Composer Task DelegateChachamaru127/claude-code-harness3.2k—~4.4kAutomated safety check: NotesMIT
Git Worktree Setupk8zdev/k8z155—~930Automated safety check: PassNone

Similar skills

  • Build Px4 macOS

    PX4/PX4-Autopilot

    Build PX4 board firmware on macOS in the px4-dev Docker container, including git worktrees, and stage commit-labeled artifacts without flashing hardware.

    13k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Worktree

    AgentsMesh/AgentsMesh

    Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.

    2.4k GitHub stars~553 tokensUpdated 14 days ago
    DevelopmentAuto-check: notes
  • Git Worktree Isolation

    jnMetaCode/superpowers-zh

    Sets up an isolated workspace before feature work or plan execution, preferring native worktree tools and falling back to git worktree, with instructions in Chinese.

    8.3k GitHub starsUsed in 1 repo~982 tokens
    DevelopmentAuto-check passed
  • Cursor Composer Task Delegate

    Chachamaru127/claude-code-harness

    Hands one implementation task to Cursor Composer in an isolated git worktree, then reviews its diff and cherry-picks the result into the main branch.

    3.2k GitHub stars~4.4k tokensUpdated 3 days ago
    DevelopmentAuto-check: notes
  • Automate git worktree creation and copy private files (not tracked in git) to new workdirs.

    155 GitHub stars~930 tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • New Feature

    michaelshimeles/skills

    Start a new task in an isolated Git worktree branched from origin/main so multiple agents can work on the same repo in parallel without conflicts.

    1.3k GitHub starsUsed in 1 repo~699 tokens
    DevelopmentAuto-check passed

More from kurotu/VRCQuestTools

All 25 skills in this repo
  • Uloop Replay Input

    kurotu/VRCQuestTools

    Replay recorded PlayMode keyboard and mouse input. An agent skill from kurotu/VRCQuestTools.

    373 GitHub starsUsed in 3 repos~615 tokens
    Auto-check passed
  • Uloop Screenshot

    kurotu/VRCQuestTools

    Capture Unity Editor windows or Game View rendering as PNG. An agent skill from kurotu/VRCQuestTools.

    373 GitHub starsUsed in 3 repos~1.2k tokens
    Auto-check passed
  • Uloop Execute Dynamic Code

    kurotu/VRCQuestTools

    Execute C with Unity APIs when existing uloop tools cannot inspect or edit enough.

    373 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Uloop Find Game Objects

    kurotu/VRCQuestTools

    Find or inspect Unity GameObjects, especially objects the user currently selected in the Hierarchy.

    373 GitHub starsUsed in 3 repos~982 tokens
    Auto-check passed
  • Uloop Record Input

    kurotu/VRCQuestTools

    Record PlayMode keyboard and mouse input to JSON. An agent skill from kurotu/VRCQuestTools.

    373 GitHub starsUsed in 1 repo~605 tokens
    Auto-check passed
  • Uloop Get Hierarchy

    kurotu/VRCQuestTools

    Get the Unity scene hierarchy as a structured tree. An agent skill from kurotu/VRCQuestTools.

    373 GitHub starsUsed in 3 repos~587 tokens
    Auto-check passed

Works with

Questions about Worktree Setup

What does Worktree Setup do?

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 Setup is an agent skill from kurotu/VRCQuestTools. 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.

When should I use Worktree Setup?

Worktree Setup fits situations like: mentions a fresh/new worktree; checkout and wants to launch Unity; run EditMode/PlayMode tests; A fresh checkout misbehaves in ways that indicate skipped setup: Unity wont open the project.

How do I install Worktree Setup in Claude Code?

Run `npx skills add kurotu/VRCQuestTools --skill worktree-setup -a claude-code`. Or copy the skill folder (.claude/skills/worktree-setup in kurotu/VRCQuestTools) into .claude/skills/worktree-setup in your project. Claude Code loads it when a task matches its description.

How do I install Worktree Setup in Codex?

Run `npx skills add kurotu/VRCQuestTools --skill worktree-setup -a codex`. Or copy the skill folder (.claude/skills/worktree-setup in kurotu/VRCQuestTools) into .agents/skills/worktree-setup in your project. Codex loads it when a task matches its description.

Can I use Worktree Setup 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 kurotu/VRCQuestTools --skill worktree-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/worktree-setup, .gemini/skills/worktree-setup, .github/skills/worktree-setup and .opencode/skills/worktree-setup in your project.

What does Worktree Setup need to run?

Going by SKILL.md and its folder, Worktree Setup needs the command-line tools its instructions call (bash and pwsh).

Does Worktree Setup 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 Worktree Setup 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 Worktree Setup use?

Worktree Setup 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 Worktree Setup use?

About 606 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Worktree Setup?

Skills that share tags, products or a category with Worktree Setup: Build Px4 macOS (PX4/PX4-Autopilot, 13k stars), Worktree (AgentsMesh/AgentsMesh, 2.4k stars), Git Worktree Isolation (jnMetaCode/superpowers-zh, 8.3k stars) and Cursor Composer Task Delegate (Chachamaru127/claude-code-harness, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Worktree Setup?

kurotu (a GitHub user) maintains it in kurotu/VRCQuestTools, which has 373 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 30, 2026.

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