Skill Definition WF2 - Bundle Browser

1---
2name: pdf
3description: Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
4license: Proprietary. LICENSE.txt has complete terms
5---
6# PDF Processing Guide
7
8## Overview
9
10This guide covers essential PDF processing operations using Python libraries and command-line tools. For advanced features, JavaScript libraries, and detailed examples, see REFERENCE.md. If you need to fill out a PDF form, read FORMS.md and follow its instructions.
11
12## Quick Start
13
14```python
15from pypdf import PdfReader, PdfWriter
16
17# Read a PDF
18reader = PdfReader("document.pdf")
19print(f"Pages: {len(reader.pages)}")
20
21# Extract text
22text = ""
23for page in reader.pages:
24    text += page.extract_text()
25```
26
27## Python Libraries
28
29### pypdf - Basic Operations
30
31**Merge PDFs**
32
33```python
34writer = PdfWriter()
35for pdf_file in ["doc1.pdf", "doc2.pdf"]:
36    reader = PdfReader(pdf_file)
37    for page in reader.pages:
38        writer.add_page(page)
39with open("merged.pdf", "wb") as output:
40    writer.write(output)
41```
42
43### pdfplumber - Text and Table Extraction
44
45Use `scripts/extract_form_structure.py` to dump the field tree before filling a form, and `scripts/check_bounding_boxes.py` to validate placement afterwards.
46
47## Command-Line Tools
48
49- `pdftotext -layout in.pdf out.txt` keeps column layout
50- `qpdf --decrypt --password=… in.pdf out.pdf` strips owner encryption
51- `gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook` compresses for email
52
53## Scanned PDFs
54
55Run OCR (`ocrmypdf --skip-text`) first; the extraction recipes above only see the text layer.