simplex-merge

Merge odd/front and reversed even/back PDFs into one ordered PDF.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the problem of incorrectly ordered double-sided document PDFs created by simplex scanning, where front pages and back pages are split across two files and the backs are in reverse order.

Core Features & Use Cases

  • Odd/Even PDF Interleaving: Merges a front (odd pages) PDF with a back (even pages) PDF by reversing the even pages and interleaving them to restore the correct reading order.
  • Simplex Post-Processing: Designed specifically for the two-PDF output pattern of simplex scanning (fronts in order, backs in reverse order).
  • Cleanup Hint for Blank Trailing Pages: Supports checking the resulting page count and removing a trailing blank page when present.

Quick Start

Provide the two existing PDFs (the odd/front file and the even/back file) and tell the AI to merge them into one correctly ordered output PDF using this skill.

Frequently Asked Questions about simplex-merge

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

FAQPage Schema
How do I merge simplex-scanned odd and even PDFs into one document?

To merge simplex-scanned odd and even PDFs, this Skill reverses the even/back pages and interleaves them with the odd/front pages, writing a new correctly ordered output PDF. It requires two existing PDFs with naming cues like odd/even or ungerade/gerade.

Why does my duplex document have reversed page order after simplex scanning?

Simplex scanning creates reversed page order in duplex documents because it scans front pages in order but back pages in reverse. This Skill fixes the issue by reversing the even/back PDF and interleaving it with the odd/front PDF.

What is the best way to interleave front and back PDF pages using pypdf?

Interleaving front and back PDF pages with pypdf involves reversing the even/back pages and alternating them with the odd/front pages. This Skill automates that exact process to restore the correct reading order and validate input/output files.

Can I automatically remove a trailing blank page after interleaving odd and even PDFs?

Yes, you can remove a trailing blank page after interleaving odd and even PDFs. This Skill supports checking the resulting page count and cleaning up a trailing blank page when present in the final merged document.

Does this PDF merging tool require specific file names for odd and even pages?

This PDF merging tool looks for naming cues like ungerade/gerade or odd/even in the working directory to identify the front and back files. Providing two existing PDFs with these cues allows the interleaving process to run successfully.