split-batch

Split multi-document searchable PDFs into individual PDFs by detecting document boundaries.

1|1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/xxthunder/xxthunder-agentic-skills --skill split-batch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: split-batch
Source: https://github.com/xxthunder/xxthunder-agentic-skills/tree/main/plugins/xxthunder-paperless-skills/skills/split-batch
Command: npx skills add https://github.com/xxthunder/xxthunder-agentic-skills --skill split-batch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, and includes scripts (resource) components.

What problem does it solve?

This Skill turns a single multi-document PDF (such as a batch of scanned paperwork) into individual PDFs by detecting document boundaries from OCR-extracted text, so you can organize, name, and process each document separately.

Core Features & Use Cases

  • Detect document boundaries from searchable-page content (page-number resets, letterhead/sender changes, and address-block transitions), or from blank separator sheets in opt-in mode.
  • Consent-gated refinement when rule confidence is medium/ambiguous: it can ask an LLM to reconcile boundaries with the extracted OCR text only when permitted.
  • Human-in-the-loop split map: proposes a split, lets you merge/split/edit boundaries, then emits one PDF per document.
  • Post-processing only: it does not scan or OCR; it requires a searchable (OCR’d) PDF.

Quick Start

Ask the agent to split your batch by proposing boundaries from the OCR text in your input PDF and then outputting one PDF per detected document after you confirm.

Frequently Asked Questions about split-batch

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

FAQPage Schema
How do I split a multi-document PDF into separate files?

To split a multi-document PDF, you need a tool that detects document boundaries from searchable text and outputs individual PDFs. This Skill extracts page text to find boundary transitions and lets you confirm the split map before generating part files.

How does detecting document boundaries from a batch scanned PDF work?

Detecting document boundaries from a batch scanned PDF works by applying offline heuristics to OCR-extracted text. It looks for page-number resets, sender changes, or address-block transitions, and can use deterministic separator sheets or consent-gated LLM escalation for ambiguous cases.

Can I split PDFs with pypdf using heuristic document boundaries?

Yes, you can split PDFs with pypdf using heuristic document boundaries. This Skill uses pypdf to extract page text and perform the final PDF splitting into part files, relying on offline heuristic detection or separator-sheet mode to find the split points.

Do I need to OCR my scanned paperwork before splitting a batch PDF?

Yes, you need to OCR your scanned paperwork before splitting a batch PDF. This is a post-processing tool that requires an already-searchable PDF file to extract page text and detect document boundaries; it does not perform scanning or OCR itself.

What happens to ambiguous document boundaries during paperless workflow splitting?

When ambiguous document boundaries are detected during paperless workflow splitting, the Skill uses a human-in-the-loop split map for confirmation. If permitted, it can also escalate the ambiguous boundaries to an LLM to reconcile them with the extracted OCR text.

Why does my multi-document PDF split not start automatically?

Your multi-document PDF split does not start automatically because the workflow is human-in-the-loop. The Skill proposes boundaries from the OCR text and requires your explicit confirmation, allowing you to merge, split, or edit boundaries before it emits one PDF per document.