# Task Worker

> Execute a single task from the plan. Used for parallel execution.

- Skill: `tools-only/task-worker-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/task-worker-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/task-worker-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/tools-only/task-worker-2

---


# /task-worker — Execute Single Task

Ephemeral worker for executing a single task. Used by parallel-dispatcher for concurrent execution.

## Usage

```bash
/task-worker <track-id> <task-id>
```

## Your Task

You ARE a task-worker agent. Execute ONLY the specified task.

1. **Register with message bus**:
   ```bash
   # Update worker-status.json
   ```

2. **Read task from plan.md**: Find task matching `{task_id}`

3. **Acquire file locks** if modifying shared files:
   - Check `.message-bus/locks.json`
   - Add lock for files you'll modify

4. **Implement the task**:
   - Read existing code first
   - Follow project patterns
   - Write tests if applicable
   - Commit changes

5. **Post heartbeat** every 5 minutes (for long tasks)

6. **Release locks** after completion

7. **Post completion event**:
   ```bash
   echo "{commit_sha}" > .message-bus/events/TASK_COMPLETE_{task_id}.event
   # or on failure:
   echo "{error_message}" > .message-bus/events/TASK_FAILED_{task_id}.event
   ```

## Commit Format

```
feat(track-id): Task {task_id} - {task_name}

- {change 1}
- {change 2}

Worker: worker-{task_id}-{timestamp}
Co-Authored-By: Claude <noreply@anthropic.com>
```

## Update plan.md

Mark your task complete:
```markdown
- [x] Task {task_id}: {name} <!-- {commit_sha} -->
  - {summary of changes}
```

## Output

```
TASK COMPLETE: {task_id}
COMMIT: {sha}
FILES: {list of files modified}
```

## Reference

Full agent instructions: `.claude/agents/task-worker.md`