pdf-convert

name	pdf_convert
description	Convert between PDF and image formats. Use when: user asks to convert PDF pages to images (PNG/JPEG) or combine images into a PDF. NOT for: text extraction (use pdf_reader), PDF editing, or document format conversion (DOCX/HTML).
dependencies	PyPDF2, Pillow
metadata	{"emoji":"🔄"}

PDF Convert Skill

Convert PDF pages to images or combine images into a PDF.

When to Use

✅ USE this skill when:

• "Convert this PDF to images"
• "Save page 3 as a PNG"
• "Make a PDF from these images"
• "Export PDF pages as JPEG"
• User wants to convert between PDF and image formats

When NOT to Use

❌ DON'T use this skill when:

• Extracting text from PDF → use pdf_reader
• Creating PDF from text/markdown → use pdf_writer
• Converting to DOCX, HTML, etc. → use specialized converters
• Merging PDFs → use pdf_merge

Usage/Commands

Images to PDF

python {skill_path}/convert_pdf.py to-pdf OUTPUT_PDF IMAGE1 IMAGE2 [IMAGE3 ...] [options]

Options:

• --dir PATH — use all images from a directory
• --fit — fit images to page (default: actual size with margins)
• --page-size A4|letter — page size (default: A4)

PDF to Images

python {skill_path}/convert_pdf.py to-images INPUT_PDF [options]

Options:

• --pages "1-5" — specific pages (default: all)
• --output DIR — output directory (default: same as input)
• --img-format png|jpeg — image format (default: png)
• --dpi 150 — resolution (default: 150)

Examples

• "Convert PDF to PNGs" → python {skill_path}/convert_pdf.py to-images doc.pdf --output ./images/
• "Make PDF from images" → python {skill_path}/convert_pdf.py to-pdf album.pdf img1.png img2.jpg
• "Page 3 as JPEG" → python {skill_path}/convert_pdf.py to-images doc.pdf --pages 3 --img-format jpeg

Notes

• Install dependencies: pip install PyPDF2 Pillow
• to-images requires a PDF rendering library; falls back to a placeholder if pdf2image/poppler is unavailable
• Supported image inputs: PNG, JPEG, BMP, TIFF, GIF