shenxingy/batch-tasks
mcp-package/skills/batch-tasks/SKILL.md
Execute TODO.md steps via unattended Claude Code sessions
$ install --global
skillsauthnpx skillsauth add shenxingy/claude-code-kit batch-tasksInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 6:10 AM102.3s2 files scanned
SKILL.md
- name:
- batch-tasks
- description:
- Execute TODO.md steps via unattended Claude Code sessions
- when_to_use:
- execute TODO.md steps, run specific tasks from a list, batch execute named tasks, 批量执行, run steps from TODO — NOT for goal-file loops (use /loop) or task planning (use /orchestrate)
- argument-hint:
- [step2 step4 ...] | "task1" "task2" ... | --run [file] | --dry-run [file] | --parallel [file]
- user_invocable:
- true
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 -psessions. - 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), oropus(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 —
--parallelflag 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, oropusbased on complexity - Tasks are written to
tasks.txtin 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 push worker output (tasks run in-tree; changes may not be committed yet).
Run /review to verify behavior anchors still pass after autonomous changes.
Related Skills
shenxingy/codex-orchestrate
development
VerifiedTrustedCommunity
Orchestrate a fleet of parallel `codex exec` workers with you (Claude Code) as the supervisor — spawn one per isolated git worktree, dispatch headless, verify each INDEPENDENTLY, PR/merge. The manual "codex-ultracode" pattern for fanning out real implementation, research, or review work onto Codex. Bakes in the hard gotchas (stdin blocking, background tracking, don't-trust-self-reports, writer isolation). Triggers on — orchestrate codex, codex workers, codex fleet, spawn codex, delegate to codex in parallel, manual ultracode, 开 codex 小弟, 派 codex worker — NOT for a single cross-vendor opinion (use the `second-opinion-codex` agent), NOT for web-UI worker decomposition (use `/orchestrate`).
8SKILL.mdUpdated Jul 16, 2026
shenxingy/worktree
development
VerifiedTrustedCommunity
Create and manage git worktrees for parallel Codex sessions
8SKILL.mdUpdated Jul 14, 2026
shenxingy/verify
development
VerifiedTrustedCommunity
Verify project behavior anchors — compilation, tests, and interaction checks after autonomous runs. NOT the Codex built-in /verify (which runs the app to observe a single change working) — this one walks the AGENTS.md "Features (Behavior Anchors)" list.
8SKILL.mdUpdated Jul 14, 2026
shenxingy/sync
documentation
VerifiedTrustedCommunity
End-of-session documentation sync — updates TODO.md and PROGRESS.md only (run /commit after to commit everything)
8SKILL.mdUpdated Jul 14, 2026