pdf-tools

Extract text, merge, split, and watermark PDFs using pypdf and pdf2image.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/winsorllc/upgraded-carnival --skill pdf-tools-winsorllc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-tools
Source: https://github.com/winsorllc/upgraded-carnival/tree/main/.pi/skills/pdf-tools
Command: npx skills add https://github.com/winsorllc/upgraded-carnival --skill pdf-tools-winsorllc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, pdf2image, pillow, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines common PDF operations, saving users time and effort on tasks like text extraction, merging, splitting, and watermarking.

Core Features & Use Cases

  • Text Extraction: Get the text content from PDF pages.
  • PDF Merging: Combine multiple PDF files into a single document.
  • PDF Splitting: Break down a PDF into individual pages or extract specific page ranges.
  • Watermarking: Add text or image watermarks to PDFs.
  • PDF to Images: Convert PDF pages into image files.
  • Use Case: You need to combine several research papers into one document, extract key information from a report, and then add a "Confidential" watermark to the final merged file.

Quick Start

Extract all text from the document named 'report.pdf' and save it to a file called 'extracted_report.txt'.

Frequently Asked Questions about pdf-tools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract text from a PDF and save it to a text file?

To extract text from a PDF, you can specify the document and the desired page range, then save the extracted text content directly to a text file for later use.

What is the best way to merge multiple PDF files into one document?

Merging multiple PDF files combines several separate documents into a single unified PDF, allowing you to consolidate research papers or reports into one easily manageable file.

How do I split a PDF into individual pages or extract a specific page range?

Splitting a PDF breaks down the original document into individual pages or extracts a specific page range, isolating only the necessary sections for targeted sharing or review.

Can I add a text or image watermark to an existing PDF?

Yes, you can add text or image watermarks to an existing PDF to stamp documents with labels such as "Confidential" or embed an image overlay for branding purposes.

Does converting PDF pages to image files require any special dependencies?

Converting PDF pages to image files requires installing Python's pdf2image and pillow libraries, and potentially requires the poppler system dependency to process the image conversion successfully.

Why would I need poppler installed for PDF to image conversion?

Poppler is a necessary system dependency for the pdf2image library to render PDF pages into image files, serving as the underlying engine for the visual conversion process.