parallel-workers

Run concurrent development workers in isolated git worktrees with lifecycle automation.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/arbgjr/smart_alarm --skill parallel-workers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parallel-workers
Source: https://github.com/arbgjr/smart_alarm/tree/main/.claude/skills/parallel-workers
Command: npx skills add https://github.com/arbgjr/smart_alarm --skill parallel-workers

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill enables teams to execute multiple implementation tasks concurrently by deploying isolated git worktrees per task, eliminating cross-task interference and accelerating delivery.

Core Features & Use Cases

  • Parallel task execution: Run multiple workers in parallel without cross-task interference.
  • Isolated worktrees: Each worker operates in its own git worktree with separate branches.
  • Lifecycle automation: Tracks states across stages and integrates with PR flows to streamline review and merge.
  • Use Case: Simultaneously develop features for different tasks (e.g., TASK-001, TASK-002) in parallel, then create PRs for review.

Quick Start

Spawn a worker: python3 .claude/skills/parallel-workers/scripts/worker_manager.py spawn --task-id "TASK-001" --description "Implement user authentication" --agent "code-author" --base-branch "feature/epic-33-claude-orchestrator" List active workers: python3 .claude/skills/parallel-workers/scripts/worker_manager.py list Get worker status: python3 .claude/skills/parallel-workers/scripts/state_tracker.py get worker-001 Cleanup merged workers: python3 .claude/skills/parallel-workers/scripts/worker_manager.py cleanup --state MERGED

Frequently Asked Questions about parallel-workers

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

FAQPage Schema
How do I run multiple coding tasks in parallel without branch interference?

You can run multiple coding tasks in parallel by spawning isolated workers, each operating in its own git worktree with a separate branch. This eliminates cross-task interference and tracks progress through state stages until PR merge.

What is the best way to automate concurrent feature development using git worktrees?

Automating concurrent feature development with git worktrees involves spawning workers per task, tracking their lifecycle states, and enforcing pre-merge validations. This skill manages worktree creation, branch isolation, and PR integration automatically.

How do I track the status of parallel workers across different git worktrees?

You track parallel worker status by using a state tracker script to query specific worker IDs. The system manages worker states across implementation stages, from spawn through PR review to final merge.

Do I need GitHub CLI to automate PR workflows for parallel git worktrees?

Yes, you need GitHub CLI installed because this skill depends on it, alongside git and yaml, to automate PR workflows, enforce pre-merge validations, and clean up merged workers across isolated worktrees.

Can I clean up git worktrees automatically after a parallel task is merged?

Yes, you can automatically clean up git worktrees after a task is merged by running the worker manager cleanup command with the merged state flag, removing isolated branches and associated worktrees.

When should I use isolated git worktrees for parallel execution instead of standard branching?

You should use isolated git worktrees for parallel execution when independent SDLC tasks require simultaneous implementation and testing. Worktrees prevent file conflicts between concurrent branches, accelerating delivery via isolated PR workflows.