| name | pdf_merge |
| description | Merge multiple PDF files into a single PDF. Use when: user asks to combine, join, or concatenate PDFs. Supports page selection and ordering. NOT for: splitting PDFs, editing content, or converting formats. |
| dependencies | PyPDF2 |
| metadata | {"emoji":"📎"} |
PDF Merge Skill
Merge multiple PDF files into one combined document using PyPDF2.
When to Use
✅ USE this skill when:
- "Merge these PDFs together"
- "Combine report1.pdf and report2.pdf"
- "Join all PDFs in this folder"
- "Append this PDF to the end of another"
- User wants to create a single PDF from multiple source PDFs
When NOT to Use
❌ DON'T use this skill when:
- Splitting a single PDF → use
pdf_split
- Creating a PDF from text → use
pdf_writer
- Extracting text from PDF → use
pdf_reader
- Converting PDF to images → use
pdf_convert
Usage/Commands
python {skill_path}/merge_pdf.py OUTPUT_PATH INPUT1 INPUT2 [INPUT3 ...] [options]
Options:
--pages "1:1-3,2:5-10" — select specific pages per input file (1-indexed, file_index:page_range)--dir PATH — merge all PDFs in a directory (alphabetical order)--reverse — reverse the input order--format json — output result as JSON
Examples
- "Merge a.pdf and b.pdf" →
python {skill_path}/merge_pdf.py combined.pdf a.pdf b.pdf
- "Merge all PDFs in reports/" →
python {skill_path}/merge_pdf.py combined.pdf --dir reports/
- "Combine only pages 1-3 of first and 5-10 of second" →
python {skill_path}/merge_pdf.py out.pdf a.pdf b.pdf --pages "1:1-3,2:5-10"
Notes
- Install dependency:
pip install PyPDF2
- Input files must be valid PDFs
- Preserves bookmarks and links when possible
