worktree-environment-setup

Prepares a selected linked Git worktree with dependencies, services, and readiness verification.

Updated May 19, 2026
One-click install
npx skills add https://github.com/wenyue/SmartKit --skill worktree-environment-setup-wenyue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: worktree-environment-setup
Source: https://github.com/wenyue/SmartKit/tree/main/setup-assets/blueprints/skills/worktree-environment-setup
Command: npx skills add https://github.com/wenyue/SmartKit --skill worktree-environment-setup-wenyue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a newly created linked Git worktree for implementation often involves ad-hoc commands that risk corrupting Git state, skipping required preparation, or leaving partial effects untracked. This Skill defines a rigorous contract for preparing an already-selected worktree while preserving Git integrity. ## Core Features & Use Cases - Git Preservation Invariant: Proves HEAD, index, refs, and commit tree remain unchanged before and after every effect, rejecting the primary checkout and ambiguous roots. - Effect Envelopes and Censuses: Requires pre-authorized effect envelopes and complete pre/post censuses that attribute every filesystem, Git, and service delta to its owner and grant. - Deterministic Results: Produces exactly one environment result (environment-ready or environment-non-ready) with functional readiness evidence, blocker details, and recovery conditions. - Use Case: After create-worktree selects a linked worktree, an agent runs this Skill to install locked dependencies, initialize inputs, start required services, and hand back verified readiness evidence. ## Quick Start Ask the agent to prepare the selected linked worktree for implementation and report whether the environment is ready.

Frequently Asked Questions about worktree-environment-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prepare a Git worktree for development automatically?▼

Use this Skill to run owner-backed dependency installation, input initialization, and service startup bound to the selected worktree's physical root. It verifies functional readiness and returns a single environment-ready or environment-non-ready result.

What is the difference between worktree environment setup and worktree creation?▼

Worktree creation selects and creates the linked worktree, while environment setup prepares an already-selected worktree with dependencies and services. Provisioning and worktree lifecycle are explicit non-goals of this Skill.

Can this Skill run against the primary checkout?▼

No. The Skill proves the lexical path, physical root, registration, and repository identity before any mutation, and rejects the primary checkout as well as ambiguous or unregistered roots.

What happens if a setup command fails or is interrupted?▼

The Skill retains process and output evidence, observes the original operation, and retries only after it ends and its owner supports repetition from the partial state. Otherwise it stops with an environment-non-ready result naming the blocker and recovery condition.

Does environment setup verify completed code changes?▼

No. Completed-change verification belongs to the separate change-set-verification Skill. This Skill only certifies environment readiness as current evidence for the create-worktree workflow.