How do I install the Nano PDF skill?

Run npx skillmds@latest add gabrielmoreira/nano-pdf in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Nano PDF skill do?

Edit PDFs with natural-language instructions using the nano-pdf CLI tool It is listed under Docs & Writing on SkillMD.

Is Nano PDF safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nano PDF?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Nano PDF free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Nano PDF?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nano PDF by gabrielmoreira — Agent Skill

Name: Nano PDF
Rating: 4.2 (5 reviews)
Author: gabrielmoreira

File contents

nano-pdf — Natural-Language PDF Editing

Use the nano-pdf CLI to perform common PDF operations — merge, split, compress, add watermarks, redact text, and more — via simple natural-language or flag-based commands.

When to Use

User wants to merge multiple PDFs into one
User wants to split a PDF into individual pages or page ranges
User wants to compress a large PDF to reduce file size
User wants to add a watermark or page numbers to a PDF
User wants to redact or remove specific pages

How to Use

1. Install nano-pdf

pip install nano-pdf
# Verify installation
nano-pdf --version

2. Merge multiple PDFs

nano-pdf merge report1.pdf report2.pdf appendix.pdf --output merged.pdf

3. Split a PDF into individual pages

# Split every page into a separate file
nano-pdf split document.pdf --output ./pages/

# Split a specific range into a new file
nano-pdf split document.pdf --pages 1-5 --output extract.pdf

4. Compress a PDF

# Default compression
nano-pdf compress large_file.pdf --output compressed.pdf

# Aggressive compression (lower image quality)
nano-pdf compress large_file.pdf --level high --output compressed.pdf

5. Add a watermark

nano-pdf watermark input.pdf --text "CONFIDENTIAL" --output watermarked.pdf
# Custom font size and opacity
nano-pdf watermark input.pdf --text "DRAFT" --size 60 --opacity 0.3 --output draft.pdf

6. Add page numbers

nano-pdf number input.pdf --position bottom-right --output numbered.pdf

7. Remove specific pages

# Remove pages 3 and 7 from a 10-page PDF
nano-pdf remove input.pdf --pages 3,7 --output trimmed.pdf

8. Rotate pages

# Rotate all pages 90 degrees clockwise
nano-pdf rotate input.pdf --degrees 90 --output rotated.pdf

# Rotate only page 2
nano-pdf rotate input.pdf --degrees 180 --pages 2 --output rotated.pdf

9. Extract images from a PDF

nano-pdf extract-images input.pdf --output ./images/

Examples

"Merge contract.pdf and appendix.pdf into one file" → Use step 2: nano-pdf merge contract.pdf appendix.pdf --output final_contract.pdf

"Compress this 50MB report so I can email it" → Use step 4 with --level high to aggressively reduce size.

"Split the quarterly report — I only need pages 10 to 15" → Use step 3 with --pages 10-15.

Cautions

nano-pdf preserves PDF/A compliance when the input is already PDF/A — check if needed for legal documents
Aggressive compression (--level high) reduces image resolution — not suitable for print-quality output
Encrypted or password-protected PDFs cannot be processed without first removing the password
Very large PDFs (> 200 MB) may require chunked processing — split first, process, then merge
nano-pdf is a Python package — confirm it is installed before use (pip show nano-pdf)

---name: nano-pdfdescription: Edit PDFs with natural-language instructions using the nano-pdf CLI toollicense: Apache-2.0---# nano-pdf — Natural-Language PDF EditingUse the `nano-pdf` CLI to perform common PDF operations — merge, split, compress, add watermarks, redact text, and more — via simple natural-language or flag-based commands.## When to Use- User wants to merge multiple PDFs into one- User wants to split a PDF into individual pages or page ranges- User wants to compress a large PDF to reduce file size- User wants to add a watermark or page numbers to a PDF- User wants to redact or remove specific pages## How to Use### 1. Install nano-pdf```powershellpip install nano-pdf# Verify installationnano-pdf --version```### 2. Merge multiple PDFs```powershellnano-pdf merge report1.pdf report2.pdf appendix.pdf --output merged.pdf```### 3. Split a PDF into individual pages```powershell# Split every page into a separate filenano-pdf split document.pdf --output ./pages/# Split a specific range into a new filenano-pdf split document.pdf --pages 1-5 --output extract.pdf```### 4. Compress a PDF```powershell# Default compressionnano-pdf compress large_file.pdf --output compressed.pdf# Aggressive compression (lower image quality)nano-pdf compress large_file.pdf --level high --output compressed.pdf```### 5. Add a watermark```powershellnano-pdf watermark input.pdf --text "CONFIDENTIAL" --output watermarked.pdf# Custom font size and opacitynano-pdf watermark input.pdf --text "DRAFT" --size 60 --opacity 0.3 --output draft.pdf```### 6. Add page numbers```powershellnano-pdf number input.pdf --position bottom-right --output numbered.pdf```### 7. Remove specific pages```powershell# Remove pages 3 and 7 from a 10-page PDFnano-pdf remove input.pdf --pages 3,7 --output trimmed.pdf```### 8. Rotate pages```powershell# Rotate all pages 90 degrees clockwisenano-pdf rotate input.pdf --degrees 90 --output rotated.pdf# Rotate only page 2nano-pdf rotate input.pdf --degrees 180 --pages 2 --output rotated.pdf```### 9. Extract images from a PDF```powershellnano-pdf extract-images input.pdf --output ./images/```## Examples**"Merge contract.pdf and appendix.pdf into one file"**→ Use step 2: `nano-pdf merge contract.pdf appendix.pdf --output final_contract.pdf`**"Compress this 50MB report so I can email it"**→ Use step 4 with `--level high` to aggressively reduce size.**"Split the quarterly report — I only need pages 10 to 15"**→ Use step 3 with `--pages 10-15`.## Cautions- nano-pdf preserves PDF/A compliance when the input is already PDF/A — check if needed for legal documents- Aggressive compression (`--level high`) reduces image resolution — not suitable for print-quality output- Encrypted or password-protected PDFs cannot be processed without first removing the password- Very large PDFs (> 200 MB) may require chunked processing — split first, process, then merge- nano-pdf is a Python package — confirm it is installed before use (`pip show nano-pdf`)

Frequently asked questions

Nano PDF