threads-skill

Coordinate multiple Claude agent threads with isolated git worktrees and event-driven messaging.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides multi-agent thread orchestration for Claude Code, enabling seamless creation, management, and coordination of multiple agent threads.

Core Features & Use Cases

  • Thread Lifecycle: Create, start, stop, pause, resume, and monitor threads with per-thread logs.
  • Git Worktrees: Isolated worktrees per thread to enable true parallel development without conflicts.
  • Event-Driven Coordination: Publish/subscribe to events, exchange artifacts, and coordinate workflows.
  • Orchestration: Run the orchestrator daemon to manage all threads from a single control point.

Quick Start

Initialize claude-threads, create a thread with an isolated worktree, and start it. Example: ct init; ct thread create demo --mode automatic --worktree; ct thread start demo

Frequently Asked Questions about threads-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?

Coordinate multiple Claude agent threads by initializing claude-threads with `ct init`, creating threads with `ct thread create`, and managing them through lifecycle commands. Each thread runs independently with isolated git worktrees, enabling true parallel development without conflicts. Use the orchestrator daemon to control all threads from a single point.

Can I run parallel development tasks without git conflicts?

Yes. Threads-skill creates isolated git worktrees per thread, allowing parallel development without conflicts. Each thread operates in its own worktree that's automatically managed and cleaned up, so multiple agents can work on the same repository simultaneously without interference.

How do I coordinate workflows between multiple agent threads?

Use event-driven coordination to exchange artifacts and synchronize workflows between threads. Publish and subscribe to events across threads, use inter-thread messaging, and monitor thread status through logs. The orchestrator daemon centralizes management and coordination of all active threads.

What's the best way to resume agent work across multiple threads?

Threads-skill supports session resumption across Claude agents through thread lifecycle management. Pause, stop, and resume threads individually or collectively. Thread state, logs, and worktree context persist, enabling seamless resumption of orchestrated workflows without losing progress.

Do I need prerequisites to set up multi-agent thread orchestration?

No external dependencies are required. Initialize claude-threads with a single command, then create and manage threads directly. The Skill handles git worktree setup, event coordination, and daemon operation automatically without additional configuration or tools.

How do I monitor and troubleshoot multiple running threads?

Monitor threads through per-thread logs, status commands, and error handling built into the orchestrator. View thread state, execution history, and diagnostic information to identify issues. The daemon provides centralized visibility across all threads and their worktree operations.