create-worktree

Create an isolated Git worktree with a dedicated branch for a story.

3|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/GDSDN/kord-aios --skill create-worktree-gdsdn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-worktree
Source: https://github.com/GDSDN/kord-aios/tree/main/src/features/builtin-skills/kord-aios/worktrees/create-worktree
Command: npx skills add https://github.com/GDSDN/kord-aios --skill create-worktree-gdsdn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires execa, chalk, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines parallel development by creating isolated Git worktrees for each story, preventing conflicts and organizing development efforts.

Core Features & Use Cases

  • Isolated Development: Each story gets its own clean working directory and Git branch.
  • Autonomous Workflow: Enables AI agents to create and manage development environments without manual intervention.
  • Use Case: Start working on a new feature ('STORY-123') without disrupting your main development branch, ensuring a clean and focused environment.

Quick Start

Use the create-worktree skill to set up a new isolated development environment for story 'STORY-456'.

Frequently Asked Questions about create-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 story development?

To create an isolated Git worktree, the Skill validates your repository, checks existing worktrees, enforces a limit, and creates a dedicated branch following the 'auto-claude/{storyId}' naming convention for clean parallel story development.

What happens if I exceed the maximum Git worktree limit?

If you exceed the maximum Git worktree limit, the Skill handles the error by preventing the creation of a new worktree, ensuring you do not surpass the enforced limit for parallel development environments.

Can I use this to set up an autonomous workflow for AI agents?

Yes, you can use this to set up an autonomous workflow for AI agents. It enables agents to automatically create and manage isolated development environments without manual intervention for specific stories.

Does this worktree creation process check if my directory is a valid Git repository?

Yes, the worktree creation process checks if your directory is a valid Git repository. It validates the repository status first and handles potential errors like non-Git directories before proceeding.

How does Git worktree isolation prevent branch conflicts during feature development?

Git worktree isolation prevents conflicts by giving each story its own clean working directory and dedicated branch. This separates development efforts, ensuring work on one feature does not disrupt your main branch.