Agent skill
pdf-compressor
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/pdf-compressor
SKILL.md
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% |
| 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
- macOS:
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?