parallel-batch

Coordinate splitting, parallel tn-writer execution, and merging of issue TSVs into notes TSV.

1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/unfoldingWord/bp-assistant-skills --skill parallel-batch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parallel-batch
Source: https://github.com/unfoldingWord/bp-assistant-skills/tree/main/.claude/skills/parallel-batch
Command: npx skills add https://github.com/unfoldingWord/bp-assistant-skills --skill parallel-batch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Split a long chapter's issue TSV into chunks and run notes in parallel to accelerate note generation for large chapters like PSA 119.

Core Features & Use Cases

  • Split the chapter's issue TSV into verse-range chunks.
  • Run tn-writer on each chunk in parallel via Task subagents.
  • Merge the per-chunk outputs into a single final notes TSV.

Quick Start

Split a long chapter's issue TSV into chunks and run tn-writer on each chunk in parallel, then merge the output notes TSV.

Frequently Asked Questions about parallel-batch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I process large chapter TSVs in parallel to speed up note generation?

To split a long chapter's issue TSV, this Skill divides the data into verse-range chunks, dispatches each chunk to a tn-writer Task subagent running in parallel, and then merges the resulting per-chunk outputs into a single final notes TSV file.

What is the best way to orchestrate parallel tn-writer execution for long chapters?

Orchestrating parallel tn-writer execution is handled by deterministically splitting the chapter issue TSV into verse-range chunks, dispatching each to a Task subagent, and merging the outputs. This provides a defined chunking strategy for long chapters like PSA 119.

When do I need to chunk a chapter's issue TSV for parallel processing?

Chunking an issue TSV is necessary for long chapters like PSA 119 where sequential processing is too slow. Splitting the file into verse-range chunks enables parallel tn-writer execution via Task subagents to accelerate note generation.

How does merging parallel TSV outputs into a single notes file work?

Merging parallel TSV outputs combines the per-chunk notes generated by each tn-writer Task subagent into a single final notes TSV. The deterministic orchestration merges all verse-range chunk outputs back into one unified file after parallel execution.

Does parallel batch processing work with standard TSV files for note generation?

Parallel batch processing works with chapter issue TSVs by splitting them into verse-range chunks and running tn-writer via Task subagents. It requires no external dependencies, orchestrating the split, parallel execution, and final merge deterministically.