Task Router Skill

# Task Router

Distributed task queue for OpenClaw multi-agent systems. Central coordination, async handoffs, capability-based routing.

## Quick Start

```bash
# Install skill
clawhub install task-router

# Register an agent
task agent register watson --capabilities "research analysis" --max-concurrent 3

# Create a task
task create --type research --title "Competitor analysis" --priority high

# Router runs automatically via heartbeat
# Check task status
task list --status pending
task show task-abc123
```

## What This Does

**Core Functions:**
- **Enqueue**: Create tasks from any session (main or sub-agent)
- **Route**: Match tasks to agents by capabilities
- **Track**: Monitor task lifecycle (pending → active → complete/failed)
- **Async Coordination**: Hand off work, check back later
- **Dead Letter**: Handle timeouts and failures
- **Rebalance**: Move stuck tasks, retry with fallbacks

**Use Cases:**
- Heartbeat creates research task → auto-routes to research agent
- Main agent spawns work → goes async, checks later
- Multi-step workflows: Task A output → Task B input
- Agent failure → task reassigned to backup agent
- Load balancing across multiple agents with same capabilities

## Configuration

### File Layout
```
~/.openclaw/task-router/
├── config.yaml           # Router settings, timeouts
├── agents.yaml           # Agent registry + capabilities
├── queue/                # Task state
│   ├── pending/          # Waiting for assignment
│   ├── active/           # Assigned to agent
│   ├── completed/        # Finished successfully
│   └── failed/           # Failed, exhausted retries
└── logs/
    └── router.log        # Routing decisions
```

### config.yaml
```yaml
router:
  check_interval: 30           # Seconds between router runs
  default_ttl: 3600            # Default task timeout
  max_retries: 2
  
  strategies:
    default: least-loaded      # round-robin | least-loaded | priority
    by_type:
      research: least-loaded
      image_gen: round-r...