thread-orchestrator-skill

Coordinate multiple Claude agent threads with isolated git worktrees.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/hanibalsk/example-claude-threads --skill thread-orchestrator-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: thread-orchestrator-skill
Source: https://github.com/hanibalsk/example-claude-threads/tree/main/.claude/skills/thread-orchestrator
Command: npx skills add https://github.com/hanibalsk/example-claude-threads --skill thread-orchestrator-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides centralized orchestration for managing multiple Claude agent threads, enabling parallel workflows with clear visibility, robust lifecycle control, and conflict-free git worktree isolation.

Core Features & Use Cases

  • Thread Lifecycle Management: Create, start, stop, resume, and monitor multiple threads across isolated worktrees.
  • Git Worktree Isolation: Each thread operates on its own branch/worktree to prevent cross-thread conflicts and simplify cleanup.
  • Event-Driven Coordination: Publish and subscribe to events across threads, share artifacts, and coordinate actions.
  • PR Review & Shepherd Support: Integrate with PR workflows to manage CI feedback and PR-based worktrees.

Quick Start

Initialize claude-threads in your project, create a new thread with an isolated worktree, and start the orchestrator. Example: ct init; ct thread create orchestrator-demo --mode automatic --worktree; ct orchestrator start.

Frequently Asked Questions about thread-orchestrator-skill

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

FAQPage Schema
How do I coordinate multiple Claude agent threads in parallel workflows?

Thread orchestrator coordinates and manages multiple Claude agent threads with isolated git worktrees, enabling parallel workflows. Create threads with `ct thread create`, assign each to its own worktree branch, and use `ct orchestrator start` to manage their lifecycle—including start, stop, resume, and monitor operations across all threads simultaneously.

What are git worktrees and why use them for multi-agent workflows?

Git worktrees allow each Claude agent thread to operate on its own branch in isolation, preventing cross-thread conflicts and simplifying cleanup. Thread orchestrator automatically manages per-thread worktrees, handling branch creation and automated pushes so agents work independently without stepping on each other's changes.

How do I share data and coordinate actions between agent threads?

Thread orchestrator supports event-driven coordination through publish-subscribe messaging and blackboard publishing. Threads emit and listen for inter-thread events to share artifacts and coordinate actions, enabling asynchronous communication patterns without direct thread coupling.

Can I integrate thread orchestrator with PR review workflows?

Yes. Thread orchestrator supports PR Shepherd integration, allowing you to watch pull requests, detect CI failures, and manage PR-based worktrees as part of your orchestrated workflows. This enables automated feedback loops and CI-driven agent coordination.

What lifecycle controls does thread orchestrator provide for agent threads?

Thread orchestrator provides complete lifecycle management: create new threads, start and stop execution, resume paused threads, check thread status, and retrieve logs. Each operation applies to isolated thread instances, giving you centralized visibility and control over parallel agent execution.

Do I need Claude Threads installed to use thread orchestrator?

Yes. Thread orchestrator requires claude-threads initialization in your project. Initialize with `ct init`, then create and manage threads using the orchestrator commands. The Skill assumes a claude-threads environment is already set up in your repository.