using-git-worktrees

Create isolated Git worktrees with directory checks and baseline tests.

134|27|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/projectbluefin/dakota --skill using-git-worktrees-projectbluefin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/projectbluefin/dakota/tree/main/.opencode/skills/using-git-worktrees
Command: npx skills add https://github.com/projectbluefin/dakota --skill using-git-worktrees-projectbluefin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers create isolated workspaces for new features or tasks without disrupting their current development environment, ensuring a clean and safe start to implementation.

Core Features & Use Cases

  • Isolated Workspaces: Utilizes Git worktrees to allow simultaneous work on multiple branches.
  • Smart Directory Selection: Prioritizes specific directory locations (.worktrees/, worktrees/, or a global config) based on project conventions and user preference.
  • Safety Verification: Automatically checks if project-local directories are ignored by Git before creating a worktree, preventing accidental commits.
  • Automated Setup: Detects project type (Node.js, Rust, Python, Go) and runs relevant dependency installation commands.
  • Baseline Testing: Executes project tests to ensure the new worktree starts from a clean, working state.
  • Use Case: When starting a new feature like "user authentication," this skill will set up a dedicated directory for that branch, install dependencies, and run tests, ensuring you can code without interference.

Quick Start

Use the using-git-worktrees skill to set up an isolated workspace for the 'feature/new-api' branch.

Frequently Asked Questions about using-git-worktrees

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

FAQPage Schema
How do I create an isolated Git worktree for feature development?

To create an isolated Git worktree, this skill systematically selects a project-local or global directory, verifies Git safety rules, and sets up the branch. It isolates feature work safely without disrupting your current development environment or main branch.

Can I automatically install dependencies when setting up a Git worktree?

Yes, you can automatically install dependencies when creating a Git worktree. The automated setup detects your project type, specifically Node.js, Rust, Python, or Go, and runs the relevant dependency installation commands immediately after directory creation.

Does using Git worktrees check if the worktree directory is ignored by Git?

Yes, using Git worktrees includes safety verification that automatically checks if project-local directories like `.worktrees/` are ignored by Git. This prevents accidental commits of the worktree folder into your main project repository.

What is the best way to ensure a clean baseline before starting feature work in a new worktree?

The best way to ensure a clean baseline is to run project tests immediately after worktree creation. This skill validates the new workspace by executing your project tests, confirming the isolated environment starts from a fully working state.

How does Git worktree directory selection work for different project conventions?

Git worktree directory selection prioritizes specific locations based on project conventions and user preference. It sequentially checks for `.worktrees/`, then `worktrees/`, and finally falls back to a global config to determine the optimal isolated workspace path.

Why should I use a Git worktree instead of switching branches in my current directory?

You should use a Git worktree to allow simultaneous work on multiple branches without disrupting your current environment. It provides a dedicated directory for each feature, automatically installing dependencies and verifying a clean baseline through testing.