Batch Tasks Skill
Read steps from TODO.md, auto-plan implementation details, and run them sequentially (or in parallel) via claude -p. Each task runs in a fresh Claude Code session with pre-generated plans.
Key features
- TODO.md integration — Reads project TODO.md, parses steps and unchecked items. Default: first uncompleted step. Specify steps:
/batch-tasks step2 step4.
- Auto-planning — Before writing tasks, the skill researches relevant files in the current session (which has codebase context) and generates detailed implementation plans with file paths, line numbers, and patterns to follow. This dramatically reduces token waste from redundant exploration in
claude -p sessions.
- Scout scoring — Each task is scored (0-100) before execution. Tasks scoring <50 are skipped and a GitHub Issue is created instead. Tasks 50-79 are flagged as risky.
- Per-task model assignment — Each task is automatically assigned
haiku (simple deletions, <20 lines), sonnet (standard features, 2-4 files), or opus (architectural, 5+ files) based on complexity.
- Per-task timeout & retries — Each task has a configurable timeout (default 10 min) and retry count (default 2). Timed-out or failed tasks are rolled back via git and retried automatically.
- Failure resilience — Failed tasks don't kill the batch. After all retries are exhausted, failures are logged to PROGRESS.md and a GitHub Issue is created automatically.
- Parallel execution —
--parallel flag runs independent tasks concurrently using git worktrees, with automatic conflict detection and merge.
- Background execution with live progress monitoring
Usage
Execute TODO steps (primary usage)
/batch-tasks # First uncompleted step from TODO.md
/batch-tasks step2 # Execute Step 2
/batch-tasks step2 step4 # Execute Steps 2 and 4
Run from quoted task descriptions
/batch-tasks "Fix sidebar padding" "Add loading skeleton to /projects"
Run / preview an existing task file
/batch-tasks --run # Serial execution
/batch-tasks --parallel # Parallel execution (git worktrees)
/batch-tasks --dry-run
How it works
- Parse TODO.md — Finds the target step(s), extracts unchecked
- [ ] items
- Planning phase — For each item, searches the codebase (Glob/Grep), reads relevant files, and generates a detailed plan with exact file paths, line numbers, and implementation steps
- Scout scoring — Each task is scored on readiness (target files found, patterns clear, no blocking deps). Tasks scoring <50 are skipped.
- Model assignment — Each task gets assigned
haiku, sonnet, or opus based on complexity
- Tasks are written to
tasks.txt in delimited block format
~/.claude/scripts/run-tasks.sh (serial) or ~/.claude/scripts/run-tasks-parallel.sh (parallel) executes tasks- Each task runs with a timeout; on failure, working tree is rolled back and the task is retried
- Logs go to
logs/claude-tasks/ with timestamps (per attempt)
- After all tasks complete: success/failure summary, failures logged to PROGRESS.md + GitHub Issue
After batch-tasks completes
Run /commit to commit worker output (tasks run in-tree; changes may not be
committed yet). It does not push — publication needs --publish or an existing
delivery authority.
Run /review to verify behavior anchors still pass after autonomous changes.
1---2name: batch-tasks-23description: Execute TODO.md steps via unattended Claude Code sessions4---56# Batch Tasks Skill78Read steps from TODO.md, auto-plan implementation details, and run them sequentially (or in parallel) via `claude -p`. Each task runs in a fresh Claude Code session with pre-generated plans.910## Key features1112- **TODO.md integration** — Reads project TODO.md, parses steps and unchecked items. Default: first uncompleted step. Specify steps: `/batch-tasks step2 step4`.13- **Auto-planning** — Before writing tasks, the skill researches relevant files in the current session (which has codebase context) and generates detailed implementation plans with file paths, line numbers, and patterns to follow. This dramatically reduces token waste from redundant exploration in `claude -p` sessions.14- **Scout scoring** — Each task is scored (0-100) before execution. Tasks scoring <50 are skipped and a GitHub Issue is created instead. Tasks 50-79 are flagged as risky.15- **Per-task model assignment** — Each task is automatically assigned `haiku` (simple deletions, <20 lines), `sonnet` (standard features, 2-4 files), or `opus` (architectural, 5+ files) based on complexity.16- **Per-task timeout & retries** — Each task has a configurable timeout (default 10 min) and retry count (default 2). Timed-out or failed tasks are rolled back via git and retried automatically.17- **Failure resilience** — Failed tasks don't kill the batch. After all retries are exhausted, failures are logged to PROGRESS.md and a GitHub Issue is created automatically.18- **Parallel execution** — `--parallel` flag runs independent tasks concurrently using git worktrees, with automatic conflict detection and merge.19- **Background execution** with live progress monitoring2021## Usage2223### Execute TODO steps (primary usage)24```25/batch-tasks # First uncompleted step from TODO.md26/batch-tasks step2 # Execute Step 227/batch-tasks step2 step4 # Execute Steps 2 and 428```2930### Run from quoted task descriptions31```32/batch-tasks "Fix sidebar padding" "Add loading skeleton to /projects"33```3435### Run / preview an existing task file36```37/batch-tasks --run # Serial execution38/batch-tasks --parallel # Parallel execution (git worktrees)39/batch-tasks --dry-run40```4142## How it works43441. **Parse TODO.md** — Finds the target step(s), extracts unchecked `- [ ]` items452. **Planning phase** — For each item, searches the codebase (Glob/Grep), reads relevant files, and generates a detailed plan with exact file paths, line numbers, and implementation steps463. **Scout scoring** — Each task is scored on readiness (target files found, patterns clear, no blocking deps). Tasks scoring <50 are skipped.474. **Model assignment** — Each task gets assigned `haiku`, `sonnet`, or `opus` based on complexity485. Tasks are written to `tasks.txt` in delimited block format496. `~/.claude/scripts/run-tasks.sh` (serial) or `~/.claude/scripts/run-tasks-parallel.sh` (parallel) executes tasks507. Each task runs with a timeout; on failure, working tree is rolled back and the task is retried518. Logs go to `logs/claude-tasks/` with timestamps (per attempt)529. After all tasks complete: success/failure summary, failures logged to PROGRESS.md + GitHub Issue5354## After batch-tasks completes5556Run `/commit` to commit worker output (tasks run in-tree; changes may not be57committed yet). It does not push — publication needs `--publish` or an existing58delivery authority.59Run `/review` to verify behavior anchors still pass after autonomous changes.
shenxingy