adaptationio/pdf-merger
.claude/skills/skill-builder-generic/examples/pdf-merger-skill/SKILL.md
Merge multiple PDF files into single document with customizable options. Supports page selection, bookmarks, and metadata. Use when combining PDFs, creating documents from multiple sources, or organizing PDF collections.
$ install --global
skillsauthnpx skillsauth add adaptationio/skrillz pdf-mergerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 31, 2026, 1:41 AM54.0s3 files scanned
SKILL.md
- name:
- pdf-merger
- description:
- Merge multiple PDF files into single document with customizable options. Supports page selection, bookmarks, and metadata. Use when combining PDFs, creating documents from multiple sources, or organizing PDF collections.
PDF Merger
Overview
Merge multiple PDF files into a single document with control over page order, bookmarks, and metadata.
Quick Start
Basic Merge
Merge all PDFs in directory:
python scripts/merge-pdfs.py --input *.pdf --output merged.pdf
Selective Merge
Merge specific files in order:
python scripts/merge-pdfs.py --input cover.pdf content.pdf appendix.pdf --output document.pdf
Common Use Cases
Use Case 1: Combine Report Sections
Merge multiple chapter PDFs into complete report:
python scripts/merge-pdfs.py \
--input ch1.pdf ch2.pdf ch3.pdf references.pdf \
--output complete-report.pdf \
--add-bookmarks
Use Case 2: Extract and Recombine Pages
Merge specific pages from different sources:
# See references/page-selection.md for syntax
python scripts/merge-pdfs.py \
--input "doc1.pdf[1-5,10]" "doc2.pdf[3-8]" \
--output combined.pdf
Use Case 3: Add Metadata
Merge PDFs with custom metadata:
python scripts/merge-pdfs.py \
--input *.pdf \
--output merged.pdf \
--title "Project Documentation" \
--author "Your Name" \
--subject "Technical Documentation"
Features
- ✓ Merge unlimited PDFs
- ✓ Preserve formatting and links
- ✓ Page selection syntax
- ✓ Bookmark generation
- ✓ Metadata customization
- ✓ Progress reporting
Script Options
python scripts/merge-pdfs.py [options]
Required:
--input FILES PDF files to merge (space-separated)
--output FILE Output PDF filename
Optional:
--add-bookmarks Create bookmark for each source file
--title TEXT Set PDF title metadata
--author TEXT Set PDF author metadata
--subject TEXT Set PDF subject metadata
--verbose Show detailed progress
Advanced Features
For advanced usage including page ranges, rotation, and custom ordering, see references/advanced-merging.md.
For comparison of PDF libraries (PyPDF2, pypdf, pdfrw), see references/pdf-libraries-comparison.md.
Troubleshooting
Issue: "Corrupted PDF" Error
Cause: Source PDF has format issues
Fix: Try repairing with python scripts/repair-pdf.py input.pdf
Issue: Large Output File
Cause: Images not compressed
Fix: Use --compress flag to reduce file size
Issue: Bookmarks Not Created
Cause: Missing --add-bookmarks flag
Fix: Add flag to command
Version: 1.0 Last Updated: October 25, 2025 Example Type: Medium skill (SKILL.md + references + script)
Related Skills
adaptationio/ttyd-remote-terminal-wsl2
development
VerifiedTrustedCommunity
Setup secure web-based terminal access to WSL2 from mobile/tablet via ttyd + ngrok/Cloudflare/Tailscale. One-command install, start, stop, status. Use when you need remote terminal access, web terminal, browser-based shell, or mobile access to WSL2 environment.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/tri-ai-collaboration
development
VerifiedTrustedCommunity
Complete development workflows where Claude writes the code while Gemini and Codex provide research, planning, reviews, and different perspectives. Claude remains the main developer. Use for complex projects requiring expert planning and multi-perspective reviews.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/todo-management
development
VerifiedTrustedCommunity
Systematic progress tracking for skill development. Manages task states (pending/in_progress/completed), updates in real-time, reports progress, identifies blockers, and maintains momentum. Use when tracking skill development, coordinating work, or reporting progress.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/testing-workflow
testing
VerifiedTrustedCommunity
Comprehensive testing workflow orchestrating functional testing, example validation, integration testing, and usability assessment. Sequential workflow for complete skill testing from examples through scenarios to integration validation. Use when conducting thorough testing, pre-deployment validation, ensuring skill functionality, or comprehensive quality checks.
6SKILL.mdUpdated Mar 28, 2026