shipit-kit:parallel-task

Create an isolated git worktree from origin/main for parallel development tasks.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/jrmatherly/shipit --skill shipit-kit-parallel-task
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shipit-kit:parallel-task
Source: https://github.com/jrmatherly/shipit/tree/main/.claude/skills/shipit-kit-parallel-task
Command: npx skills add https://github.com/jrmatherly/shipit --skill shipit-kit-parallel-task

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, pnpm, and includes scripts (resource) components.

What problem does it solve?

This Skill creates an isolated git worktree so you can work on a feature or bugfix in parallel without contaminating your current branch or interrupting other agent sessions, builds, or long-running tests.

Core Features & Use Cases

  • Create a new worktree under .worktrees/ branched from origin/main and ensure the branch name is unique.
  • Scaffold a specs directory for the feature, patch the generated feature metadata to match the actual branch, and commit the spec scaffold.
  • Use cases include running long builds or tests in a separate worktree, starting independent AI agent sessions per feature, and safely isolating experimental refactors or fixes.

Quick Start

Create a parallel worktree for "add retry logic to agent HTTP calls", initialize the feature spec, run dependency installation in the new worktree, and open it in your editor.

Frequently Asked Questions about shipit-kit:parallel-task

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

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

To create an isolated git worktree, this Skill automatically branches from origin/main, establishes a unique branch name, scaffolds a specs directory, and instructs dependency installation. It isolates parallel feature tasks without contaminating your current branch or interrupting active builds.

What is the best way to run multiple AI agent sessions on different features concurrently?

Running multiple AI agent sessions concurrently is best achieved by creating isolated git worktrees for each session. This Skill instantly generates separate worktrees under .worktrees/ from origin/main, ensuring each concurrent agent operates safely without interrupting other work.

Can I use pnpm to install dependencies in a new git worktree?

Yes, you can use pnpm to install dependencies in a new git worktree. After the Skill creates the isolated worktree and scaffolds the feature spec, it provides explicit guidance to run the pnpm dependency installation process before you open the new worktree in your editor.

Does this parallel development approach scaffold feature specs automatically?

Yes, this parallel development approach scaffolds a specs directory automatically. During worktree creation, it initializes the feature spec, patches the generated feature metadata to match the actual unique branch name, and commits the spec scaffold directly to the new branch.

When should I use git worktrees instead of stashing changes or branching in place?

You should use git worktrees instead of stashing changes when running long builds, starting independent AI agent sessions, or isolating experimental refactors. Worktrees provide a separate physical directory to run parallel development tasks safely without interrupting your current branch or losing context.