{
  "id": "page:docs-reference-repos-deusyu-translate-book-research",
  "_kind": "Page",
  "_file": "wiki/docs/reference-repos/deusyu/translate-book/research.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/reference-repos/deusyu/translate-book/research.md",
    "sourceKind": "repo-docs",
    "title": "deusyu/translate-book",
    "displayName": "deusyu/translate-book",
    "slug": "docs/reference-repos/deusyu/translate-book/research",
    "articlePath": "wiki/docs/reference-repos/deusyu/translate-book/research.md",
    "article": "\n# deusyu/translate-book\n\n- **Archetype**: utility-with-skill\n- **Stars**: 616\n- **Last pushed**: 2026-04-04\n- **License**: MIT\n- **Discovered**: 2026-04-12\n- **Skills found**: 1\n\n## Summary\nClaude Code skill that translates entire books (PDF/DOCX/EPUB) into any language using parallel subagents. Implements a multi-step pipeline: collect parameters -> preprocess (convert to Markdown chunks via Python script) -> discover chunks -> parallel translate (1 chunk = 1 subagent = 1 fresh context) -> reassemble. Default concurrency of 8 parallel subagents per batch. Supports custom translation instructions. The skill explicitly declares allowed-tools and has openclaw metadata requiring python3, pandoc, and calibre/ebook-convert binaries.\n\n## Assessment\nMEDIUM-HIGH VALUE. The parallel subagent pattern for large document processing maps directly to babysitter's ctx.parallel.map() pattern. Key design decisions are transferable: 1 chunk = 1 subagent = 1 fresh context (prevents context accumulation and output truncation), batch-based dispatch respecting API rate limits, manifest.json for tracking chunk state, and the preprocess -> parallel process -> reassemble pipeline. The allowed-tools declaration and openclaw requires metadata show how to declare skill dependencies on external binaries. The chunking + manifest pattern is applicable to any embarrassingly parallel document processing task.\n\n## Extraction Priority\n- Medium\n- Rationale: The parallel document processing pipeline is directly extractable as a babysitter process. The 1-chunk-1-subagent-1-context pattern and batch-based rate limit management are reusable orchestration patterns. However, the translation-specific logic is not broadly transferable. Best suited for specializations/shared/large-document-processing as a methodology template.\n\n## Processes\n- **Parallel Document Translation Process**: Collect parameters (file, target language, concurrency, custom instructions) -> preprocess with convert.py (PDF/DOCX/EPUB -> HTML -> Markdown -> chunks + manifest) -> discover untranslated chunks (source chunks minus output_chunks) -> translate in parallel batches (concurrency subagents per batch) -> reassemble translated chunks -> export to target format. A complete babysitter process with ctx.parallel.map() for the translation phase.\n- **Large Document Chunking Pipeline**: Convert source format -> split into manageable chunks -> generate manifest for tracking -> process chunks in parallel -> reassemble. A reusable template for any large-document processing task (translation, summarization, analysis, transformation).\n\n## Plugin Ideas\n- **Book Translation plugin**: Install.md-driven plugin that sets up the translation pipeline. Install.md verifies python3, pandoc, and calibre dependencies, installs the convert.py script, and configures default concurrency. Provides a /translate-book skill.\n- **Parallel Document Processor plugin**: A generic document chunking + parallel processing framework. Install.md configures chunk size, concurrency limits, and processing strategy. Adaptable for translation, summarization, or any chunk-level transformation.\n\n## Patterns\n- **1 chunk = 1 subagent = 1 fresh context**: Each chunk gets its own independent subagent with fresh context to prevent context accumulation and output truncation. Critical for quality in large-document processing.\n- **Batch-based parallel dispatch**: Launch up to N subagents per batch, wait for batch completion before launching next. Respects API rate limits while maximizing parallelism.\n- **Manifest-based progress tracking**: manifest.json tracks all chunks and their processing state. Enables resume-from-failure by discovering which chunks lack output files.\n- **Incremental progress detection**: Glob for source chunks vs output chunks to determine remaining work. Supports idempotent re-execution.\n- **Binary dependency declaration**: openclaw metadata declaring required binaries (python3, pandoc, ebook-convert) with anyBins for alternatives (calibre OR ebook-convert). A dependency specification pattern for skills with external tool requirements.\n- **Preprocess -> parallel process -> reassemble**: The canonical pipeline for embarrassingly parallel document processing. Reusable across translation, summarization, analysis, and transformation tasks.\n\n## Library Mapping\n\n| Extractable Process | Library Status | Action | Existing Path | Target Placement |\n|-------------------|----------------|--------|---------------|------------------|\n| Parallel Document Translation Process | NEW | Complete book translation pipeline with chunking and parallel subagent processing | - | specializations/creative/parallel-document-translation.js |\n| Large Document Chunking Pipeline | NEW | Generic document chunking with manifest tracking for parallel processing | - | specializations/shared/large-document-chunking-pipeline.js |\n| Batch-Based Parallel Dispatch | UPGRADE | Enhanced parallel processing with rate limit management and batch coordination | library/specializations/shared/orchestration-patterns.js | specializations/shared/batch-based-parallel-dispatch.js |\n| Manifest-Based Progress Tracking | NEW | Progress tracking system for resumable parallel operations | - | specializations/shared/manifest-based-progress-tracking.js |\n| Fresh Context Per Chunk Pattern | NEW | 1 chunk = 1 subagent = 1 fresh context for quality large-document processing | - | specializations/shared/fresh-context-per-chunk.js |\n| Multi-Format Document Preprocessing | NEW | PDF/DOCX/EPUB conversion to processable formats via pandoc and calibre | - | specializations/shared/multi-format-document-preprocessing.js |\n| Incremental Processing Detection | NEW | Resume-from-failure by comparing source vs output chunks | - | specializations/shared/incremental-processing-detection.js |\n| Binary Dependency Management | NEW | External tool dependency declaration and validation patterns | - | specializations/shared/binary-dependency-management.js |\n\n## Plugin Marketplace Mapping\n\n| Plugin Idea | Marketplace Status | Action | Existing Plugin | Target Placement |\n|-------------|-------------------|--------|-----------------|------------------|\n| Pandoc Integration | NEW | Document format conversion via pandoc CLI tool | - | plugins/a5c/marketplace/plugins/pandoc-integration/ |\n| Calibre Integration | NEW | E-book format conversion and processing via calibre tools | - | plugins/a5c/marketplace/plugins/calibre-integration/ |\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-reference-repos",
      "to": "page:docs-reference-repos-deusyu-translate-book-research",
      "kind": "contains_page"
    }
  ]
}