🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Nested PDF Merger

by @lyutenant

Use this skill when the task is to merge PDFs from a nested directory tree into a single PDF with hierarchical bookmarks by invoking the external `nestedpdfm...

Versionv1.0.0
Downloads615
TERMINAL
clawhub install nested-pdf-merger

πŸ“– About This Skill


name: nested-pdf-merger description: Use this skill when the task is to merge PDFs from a nested directory tree into a single PDF with hierarchical bookmarks by invoking the external nestedpdfmerger CLI. This skill depends on the nestedpdfmerger binary being installed and available on PATH. metadata: {"openclaw":{"requires":{"bins":["nestedpdfmerger"]},"homepage":"https://github.com/Lyutenant/nested-pdf-merger"}}

Nested PDF Merger

This repository wraps the external nestedpdfmerger CLI.

Do not implement PDF merging logic in this repository. Do not modify anything under reference/.

Requirements

This skill requires the nestedpdfmerger command to be installed and available on PATH.

Expected installation command:

pip install nestedpdfmerger

Expected CLI entrypoint:

nestedpdfmerger INPUT_DIR -o OUTPUT.pdf [options]

Alternative module invocation:

python -m nestedpdfmerger INPUT_DIR -o OUTPUT.pdf [options]

When to use

Use this skill when the user wants to:

  • Merge PDF files from a folder tree into one output PDF.
  • Preserve the folder hierarchy as PDF bookmarks.
  • Preview merge order with --dry-run.
  • Exclude directories, change sort order, or disable bookmarks.
  • Workflow

    1. Confirm the input directory and desired output path. 2. Prefer --dry-run first when the user wants to validate merge order. 3. Run the CLI with the smallest set of flags needed. 4. If the command fails because the binary is missing, tell the user to install it with pip install nestedpdfmerger.

    Supported flags

  • -o, --output PATH
  • --sort {natural,alpha,mtime}
  • --reverse
  • --exclude NAME [NAME ...]
  • --exclude-hidden
  • --no-bookmarks
  • --dry-run
  • --strict
  • --verbose
  • --quiet
  • --version
  • Examples

    Preview merge order:

    nestedpdfmerger ./reports --dry-run
    

    Merge with explicit output:

    nestedpdfmerger ./reports --output merged.pdf
    

    Merge while excluding folders:

    nestedpdfmerger ./reports --output merged.pdf --exclude Backup Data
    

    ⚑ When to Use

    TriggerAction
    - Merge PDF files from a folder tree into one output PDF.
    - Preserve the folder hierarchy as PDF bookmarks.
    - Preview merge order with `--dry-run`.
    - Exclude directories, change sort order, or disable bookmarks.

    πŸ’‘ Examples

    Preview merge order:

    nestedpdfmerger ./reports --dry-run
    

    Merge with explicit output:

    nestedpdfmerger ./reports --output merged.pdf
    

    Merge while excluding folders:

    nestedpdfmerger ./reports --output merged.pdf --exclude Backup Data