AgentSkillsCN

pdf-combine

将多个 PDF 文件合并为单个 PDF。当用户：(1) 希望合并 PDF 文件；(2) 提及“合并 PDF”、“PDF 合并”或“PDF 联合”；(3) 用户拥有需要整合的多个 PDF 时，可使用此技能。系统会严格遵守文件顺序：当提供目录时，文件按字母顺序排序；当提供具体文件路径时，将按照用户指定的顺序进行合并。

SKILL.md
--- frontmatter
name: pdf-combine
description: "Combine multiple PDF files into a single PDF. Use when: (1) User wants to merge PDF files, (2) User mentions 'combine PDFs', 'merge PDFs', or 'join PDFs', (3) User has multiple PDFs that need to be consolidated. Respects file order: when given a directory, files are sorted alphabetically; when given specific file paths, the order provided is preserved."

Combine PDF Files

Combine multiple PDF files into a single PDF document.

Usage

The user can specify:

  • •A directory containing PDF files (files will be sorted alphabetically by filename)
  • •Multiple specific PDF file paths (order is preserved as given)
  • •Output file path for the combined PDF

Script Details

  • •Script location: /Users/takazudo/.claude/skills/pdf-combine/scripts/combine_pdfs.py
  • •Dependency: PyMuPDF (fitz) - pip install PyMuPDF

Instructions

  1. •

    Determine the source PDF files:

    • •If user provides a directory, all PDFs in that directory will be combined in alphabetical order
    • •If user provides specific file paths, use them in the exact order provided
  2. •

    Determine the output file path:

    • •If user specifies an output path, use it
    • •If not specified, ask the user for the output file name/path
  3. •

    Run the combine script:

    bash
    python3 /Users/takazudo/.claude/skills/pdf-combine/scripts/combine_pdfs.py <input1.pdf> <input2.pdf> ... -o <output.pdf>

    Or for a directory:

    bash
    python3 /Users/takazudo/.claude/skills/pdf-combine/scripts/combine_pdfs.py <directory> -o <output.pdf>
  4. •

    Report the results to the user (number of files combined, total pages, output location)

Examples

Combine specific files in order

bash
python3 /Users/takazudo/.claude/skills/pdf-combine/scripts/combine_pdfs.py \
  chapter1.pdf chapter2.pdf chapter3.pdf \
  -o book.pdf

Combine all PDFs in a directory (alphabetical order)

bash
python3 /Users/takazudo/.claude/skills/pdf-combine/scripts/combine_pdfs.py \
  ./documents/ \
  -o combined.pdf

Order Rules

  • •Directory input: Files are sorted alphabetically by filename (case-insensitive)
  • •Explicit file list: Files are combined in the exact order provided by the user
  • •If user wants a specific order for files in a directory, they should provide the files explicitly

Error Handling

  • •If a file doesn't exist, the script will report an error
  • •If no PDF files are found in a directory, the script will report an error
  • •Non-PDF files are skipped with a warning