PDF Compressor

Documents

pdf-compressor

PDF Compressor is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Compress large PDF files by resizing pages and optimizing images. Use when PDF file size is too large for sharing, uploading, or when Gemini generates oversized slides. Reduces file size by up to 98% while maintaining acceptable quality.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/pdf-compressor/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pdf-compressor, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

PDF Compressor

Compress PDF files by converting pages to optimized images and rebuilding the PDF.

Workflow

Convert PDF pages to images at specified DPI
Resize images to target width (maintaining aspect ratio)
Compress as JPEG with quality setting
Rebuild PDF from compressed images

Usage

python scripts/compress.py "{pdf_path}" --width {width} --quality {quality} --output "{output_path}"

Parameters

Parameter	Required	Default	Description
pdf_path	Yes	-	Path to PDF file to compress
--width	No	1920	Page width in pixels
--quality	No	85	JPEG quality (1-100)
--dpi	No	150	DPI for PDF to image conversion
--output, -o	No	auto	Output path (default: {filename}_compressed.pdf)

Quality Presets

Use Case	Width	Quality	Expected Reduction
Web/Email	1280	75	~95%
Standard	1920	85	~90%
High Quality	2560	90	~80%
Print	3840	95	~60%

Examples

# Basic compression (default settings)
python scripts/compress.py "large_presentation.pdf"

# Web-optimized (smaller file)
python scripts/compress.py "slides.pdf" --width 1280 --quality 75

# High quality for presentations
python scripts/compress.py "report.pdf" --width 2560 --quality 90

# Custom output path
python scripts/compress.py "document.pdf" -o "document_small.pdf"

Requirements

Python packages: pdf2image, Pillow, img2pdf
System: poppler (for pdf2image)
- macOS: brew install poppler
- Ubuntu: apt-get install poppler-utils

Notes

Original PDF is not modified
Text becomes rasterized (not searchable)
Best for image-heavy presentations and slides
For text-heavy documents, consider Ghostscript instead