Skip to content
Skills Library
Documents & office · Conversion & formats

pdf

/pdf

Use when PDF files are the primary input or output: read, compare, reconcile, extract text/tables/images, OCR scans, fill forms, split, merge, rotate, rename, compress, or convert between PDF and images. Optimized for private financial, tax, legal, and health documents on macOS.

Licence
MIT
Last repository change
24.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
2
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 24.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 2 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/form.py, scripts/profile.py

What it does and when to use it

Use when PDF files are the primary input or output: read, compare, reconcile, extract text/tables/images, OCR scans, fill forms, split, merge, rotate, rename, compress, or convert between PDF and images. Optimized for private financial, tax, legal, and health documents on macOS.

Arguments

/pdf [file ...]
Original author description

Use when PDF files are the primary input or output: read, compare, reconcile, extract text/tables/images, OCR scans, fill forms, split, merge, rotate, rename, compress, or convert between PDF and images. Optimized for private financial, tax, legal, and health documents on macOS.

How it works

  1. Invariants
  2. Profile First
  3. Route by Evidence
  4. Execute and Reconcile
Original SKILL.md headings · 73 lines, 668 words
SKILL.md preview
---
argument-hint: "[file ...]"
compatibility: Requires macOS, uv, Poppler, qpdf, Ghostscript, OCRmyPDF with Tesseract language data, and img2pdf.
name: pdf
description:
  "Use when PDF files are the primary input or output: read, compare, reconcile, extract text/tables/images, OCR scans,
  fill forms, split, merge, rotate, rename, compress, or convert between PDF and images. Optimized for private
  financial, tax, legal, and health documents on macOS."
---

# PDF

Process PDFs locally on macOS with exact extraction, source preservation, deliberate tool routing, and structural plus
semantic validation.

## Invariants

1. Run extraction and transformations locally. Task-relevant document evidence in tool output and internal agent reports
   may be processed by the configured model provider. Require explicit user authorization and an external-disclosure
   review before uploading or sending document contents outside that agent workflow. Package and language-data downloads
   do not authorize document disclosure.
2. Preserve every original PDF byte-for-byte. Unless the user authorizes destructive replacement, write a sibling
   output, copy, or explicitly named destination.
3. Preserve monetary values, identifiers, dates, signs, and displayed precision as strings. Use `decimal.Decimal` for
   arithmetic. Never infer missing rows or silently discard headers, footnotes, continuation lines, or boundary pages.
4. Inspect structure and representative renders before choosing a transformation. Use the smallest tool that preserves
   the required layout, forms, annotations, and image quality.
5. Validate every written PDF structurally and against task semantics. A command exiting successfully is not evidence
   that extracted rows, totals, page boundaries, form appearances, or visual layout are correct.
6. Keep reports concise for private financial, tax, legal, and health documents. Prefer counts, reconciliations, and
   file references over raw sensitive rows unless the rows materially support the task or the user asks for them.

## Profile First

Resolve the skill directory from this `SKILL.md`, then profile every unknown input:

```sh
uv run "<skill-dir>/scripts/profile.py" "<input.pdf>"
```

The helper emits schema-versioned JSON with integrity, encryption, page geometry/rotation, image counts, and per-page
text coverage without document text. Stop on `password_required`. Password handling is outside this skill.

When layout, cropping, OCR quality, signatures, or form placement matters, render the first and last page, every
structural boundary, and any page behind a discrepancy. For dense charts, tables, or technical drawings, render at
higher resolution and crop or zoom the relevant region before reading values.

## Route by Evidence

| Need                                      | Preferred route                                                          |
| ----------------------------------------- | ------------------------------------------------------------------------ |
| Quick reading or page-aware extraction    | Host PDF reader when available, then `pdftotext -layout`                 |
| Coordinates, columns, or difficult tables | Poppler bounding boxes, then `pdfplumber` through `uv run`               |
| Image-only or materially incomplete text  | OCRmyPDF with Tesseract. Default languages: `eng+ron`                    |
| Merge, split, rotate, or integrity checks | qpdf                                                                     |
| Render pages or extract embedded images   | `pdftocairo` or `pdfimages`                                              |
| Convert ordered images into a PDF         | img2pdf                                                                  |
| Reduce size                               | qpdf lossless rewrite first. Ghostscript only for an accepted lossy pass |
| Inspect, fill, flatten, or overlay forms  | Read [references/forms.md](references/forms.md) first                    |

Only when exact commands for the selected extraction, transformation, OCR, image, comparison, or compression branch are
needed, read [references/recipes.md](references/recipes.md).

## Execute and Reconcile

1. Profile inputs and identify whether each page is digital, scanned, mixed, rotated, or image-heavy.
2. Extract or transform into a new path. For tabular documents, retain page provenance and parse continuations across
   page breaks before assigning rows.
3. Reconcile financial and evidentiary output with every available invariant: page and row counts, opening/closing
   balances, inflows/outflows, subtotals, displayed totals, date coverage, and source hashes when provenance matters.
4. For comparisons, extract both sources independently, enumerate overlapping and unique facts, and render the pages
   behind every material disagreement. Distinguish a real discrepancy from an extraction failure.
5. For split or rename work, establish an old-to-new map from stable content identifiers. Copy by default, preserve
   contextual boundary pages when needed, and verify the first and last page of every result.
6. Validate outputs with qpdf, expected page count/dimensions, text coverage, representative renders, and the task's
   semantic invariants. Retain OCR sidecars or extraction intermediates only when they are requested or useful evidence.

Completion requires preserved originals, intentional outputs, successful structural checks, semantic reconciliation, and
a concise report of paths and evidence. Lead read-only reports with `### 📄 PDF — 🔎 inspected, no files written`. Only
after all required validation passes, use `### 📄 PDF — ✅ updated`. When a required check fails, use
`### 📄 PDF — ⛔ not deliverable`.
Files in this package (6)
  • SKILL.md 6 KB
  • agents/openai.yaml 1 KB
  • references/forms.md 3 KB
  • references/recipes.md 5 KB
  • scripts/form.py 14 KB
  • scripts/profile.py 7 KB

Versions

RepositoryScoreLicence
This page · PaulRBerg/agent-skills100MIT
chris-peterson/fathom100MIT
shunwuyu/ai_lesson100MIT
rongxinzy/rongxinai100AGPL-3.0
mateaix/mateclaw100Apache-2.0
Navinspire-ia/navin100AGPL-3.0
ai-workspace-lab/xworkspace-core-skills100MIT
astrbotdevs/astrbot100AGPL-3.0
openbmb/pilotdeck100AGPL-3.0

Database snapshot: 13.11.2026 · package version 6e1678a3e88c (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100processing-pdf
    Use when the user needs to extract data from PDFs, work with scanned documents, or manipulate PDF files. Triggers include: "extract text from PDF", "convert PDF to text/CSV/images", "scan/OCR this document", "merge/split/rotate PDF", "fill PDF form", "PDF is blank/empty" (likely…
  • 100pdf-batch
    Run one PDFTrusted tool over many files or a whole folder — compress every PDF, convert a folder of PDFs to Word or Excel, OCR all scans, add page numbers or a watermark to each file, convert all images or office files to PDF, or merge a folder into one PDF in a chosen order.…
  • 100document-processing
    This skill should be used when the user says \"process documents\", \"extract text from PDF\", \"OCR this document\", \"convert PDF to markdown\", \"extract emails from documents\", \"parse document\", \"document conversion\", \"batch OCR\", \"extract structured data from PDF\",…
  • 100pdf-extractor
    This skill should be used when the user asks to "extract text from PDF", "convert PDF to text", "parse PDF", "read PDF contents", "extract data from documents", "batch PDF extraction", "PDF to markdown", "OCR PDF", "get text from PDF files", "I have a PDF", "can you read this…
  • 100pdf-processing
    Inspect, extract, OCR, create, merge, split, reorder, rotate, annotate, fill, redact, compress, secure, and verify PDF documents while preserving source files and visual fidelity. Use when working with one or more .pdf files; converting documents to or from PDF; extracting text,…
  • 90pdf-skill
    All-in-one PDF read / write / convert / OCR. Trigger scenarios: summarize a PDF, extract text or tables, fill an AcroForm, render pages as images, merge, split, add a watermark, rotate, encrypt/decrypt, create a new PDF (invoice / report / receipt), convert between PDF and…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.