# PDF

> Skill `pdf` on Faro. 7 sub-skills.

Reads, creates, and transforms PDF files: extract text and data, merge or split documents, fill interactive forms, stamp or watermark every page, and compress files for faster sharing. All operations work on files you provide by URL and return either a new PDF file or the extracted content inline.

**Category:** Documents  
**Tags:** pdf, merge, split, extract, forms, watermark, compress  
**Use when:** You have one or more PDFs to combine, break apart, read, fill, watermark, or shrink.  
**Not for:** Reading scanned or photographed PDFs (OCR), creating a PDF from scratch or from Office files, encrypting, rotating, or redacting.  
**Returns:** file (application/pdf) — Returns a downloadable file (a single PDF, or a zip when a split yields several). Reading text or tables instead returns the content inline.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/pdf/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Merge these two PDFs into one"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run pdf "Merge these two PDFs into one"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Merge these two PDFs into one
- Extract pages 3 to 7 from this PDF
- Extract all the text from this PDF
- Pull the table from page 3 of this PDF

## Sub-skills

### Combine PDFs

Joins several PDFs into one file, in the order given.

**Cost:** ~1 credits / page (up to 50) — Billed at 0.1 credits per page of the combined output.

**Use when:** You want to concatenate two or more PDFs into a single document.

**Details:** https://askfaro.com/llms/skills/pdf/merge.md

---

### Split a PDF

Extracts page ranges, fixed-size chunks, or single pages from a PDF.

**Cost:** ~1 credits / page (up to 50) — Billed at 0.1 credits per page processed.

**Use when:** You want specific pages, a chapter, or per-page files out of one PDF.

**Details:** https://askfaro.com/llms/skills/pdf/split.md

---

### Extract text

Pulls the text out of a PDF, per page and combined.

**Cost:** ~1 credits / page (up to 50) — Billed at 0.1 credits per page read.

**Use when:** You want to read, summarize, or quote from a text-based PDF.

**Details:** https://askfaro.com/llms/skills/pdf/extract_text.md

---

### Extract tables

Detects tables in a PDF and returns them as rows.

**Cost:** ~1 credits / page (up to 50) — Billed at 0.1 credits per page scanned for tables.

**Use when:** You want tabular data from a clean, ruled table as structured rows.

**Details:** https://askfaro.com/llms/skills/pdf/extract_tables.md

---

### Fill a form

Sets a fillable PDF's field values and returns the completed file.

**Cost:** ~1 credits / page (up to 50) — Billed at 0.1 credits per page of the form.

**Use when:** You have a fillable PDF form and the values to put in its fields.

**Details:** https://askfaro.com/llms/skills/pdf/fill_form.md

---

### Stamp or watermark

Overlays text or a logo on every page of a PDF.

**Cost:** ~1 credits / page (up to 50) — Billed at 0.1 credits per page stamped.

**Use when:** You want a CONFIDENTIAL/DRAFT watermark or a logo on every page.

**Details:** https://askfaro.com/llms/skills/pdf/stamp.md

---

### Compress

Shrinks a PDF's file size and optimizes it for fast web viewing.

**Cost:** ~2 credits / MB (up to 20) — Billed at 0.1 credits per MB of the input file, regardless of how much it shrinks.

**Use when:** You want a smaller PDF to email or upload, or a web-optimized one.

**Details:** https://askfaro.com/llms/skills/pdf/compress.md

---

---
On the web: https://askfaro.com/search/pdf