bk-worktree

Create and manage isolated Git worktrees for parallel development.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/dikini/knot --skill bk-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bk-worktree
Source: https://github.com/dikini/knot/tree/main/.agents/skills/bk-worktree
Command: npx skills add https://github.com/dikini/knot --skill bk-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of creating and managing isolated Git worktrees, preventing conflicts and keeping your main development environment clean.

Core Features & Use Cases

  • Feature Isolation: Create separate, clean environments for developing new features or fixing bugs.
  • Parallel Development: Work on multiple tasks simultaneously without interfering with each other.
  • Use Case: When starting a new, complex feature, use this Skill to create an isolated worktree so your main branch remains stable for urgent fixes or other ongoing tasks.

Quick Start

Use the bk-worktree skill to create a new worktree for the feature named 'new-login-flow'.

Frequently Asked Questions about bk-worktree

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

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

To create an isolated git worktree, you specify a feature name, a base branch, and a task reference. This generates a separate, clean directory environment for parallel development without interfering with your main branch.

What is the best way to manage parallel development tasks without causing git branch conflicts?

Managing parallel development tasks without conflicts requires isolated git worktrees. This approach creates separate working directories linked to the same repository, keeping your main environment stable while you develop new features or fix bugs independently.

When do I need to set up an isolated git worktree instead of a standard local branch?

You need an isolated git worktree when starting a complex feature that requires a clean environment. It allows you to work on multiple tasks simultaneously without switching branches or risking instability in your main development area.

How do I initialize the environment and record context when starting a new git worktree?

After creating a git worktree with a specified feature name, you run the included environment initialization and context recording workflows. This sets up your isolated workspace and logs the task reference to maintain development context.

Does the bk-worktree skill include workflows for worktree cleanup after feature isolation?

Yes, the bk-worktree skill includes dedicated cleanup workflows. Once your parallel development or feature isolation tasks are complete, these workflows manage the removal of the isolated git worktree to keep your workspace clean.

Can I specify a base branch and task reference when creating a new git worktree?

Yes, you can specify a base branch and a task reference when creating a new git worktree. This ensures the isolated environment branches directly from the correct version control point and links to your specific development task.