- 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
nestedpdfmergerCLI. This skill depends on thenestedpdfmergerbinary 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 nestedpdfmergerExpected 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
- Confirm the input directory and desired output path.
- Prefer
--dry-runfirst when the user wants to validate merge order. - Run the CLI with the smallest set of flags needed.
- 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-runMerge with explicit output:
nestedpdfmerger ./reports --output merged.pdfMerge while excluding folders:
nestedpdfmerger ./reports --output merged.pdf --exclude Backup Data