---
name: documento-pdf
description: Use quando quiser trabalhar com arquivos PDF — extrair texto/tabelas, juntar, dividir, preencher formulário, gerar PDF ou aplicar OCR. Ótimo para contratos e processos.
---

# Trabalhar com PDF

> Inspirada na skill oficial de PDF da Anthropic. Usa Python (já instalado).

## Quando usar
- Extrair o texto de um contrato/processo para analisar (com `/analisar-contrato`, `/resumir-processo`).
- Juntar anexos, dividir um PDF grande, preencher formulário ou gerar um PDF.

## Requisitos (instale conforme a tarefa — confirme antes)
```
pip install pypdf pdfplumber reportlab
```

## Receitas por tarefa
**Extrair texto:**
```python
import pdfplumber
with pdfplumber.open("doc.pdf") as pdf:
    texto = "\n".join((p.extract_text() or "") for p in pdf.pages)
```
**Extrair tabelas:** `pagina.extract_tables()` (pdfplumber).

**Juntar / dividir:**
```python
from pypdf import PdfReader, PdfWriter
w = PdfWriter()
for f in ["a.pdf", "b.pdf"]:
    for pg in PdfReader(f).pages:
        w.add_page(pg)
with open("juntado.pdf", "wb") as out:
    w.write(out)
```
**Gerar PDF:** `reportlab` (`SimpleDocTemplate` + `Paragraph`).
**PDF escaneado (imagem) → OCR:** `pytesseract` + `pdf2image` (requer o Tesseract instalado).

## Erros comuns
- PDF escaneado não tem texto "real" → precisa de OCR.
- No Windows, o console mostra acentos errados, mas o texto salvo em UTF-8 está certo — **valide no arquivo, não no terminal**.

## Regras
- Não instale libs pesadas sem confirmar.
- Documento jurídico: confira o texto extraído contra o original.
- Nunca invente conteúdo que não está no PDF.

## Relacionadas
`/analisar-contrato` · `/resumir-processo` · `/documento-word`