PDF Skill

Skill PDF

Quando usar

• Ler ou revisar conteúdo de PDF onde o layout e os elementos visuais importam.
• Criar PDFs programaticamente com formatação confiável.
• Validar a renderização final antes da entrega.

Fluxo de trabalho

1. Prefira revisão visual: renderize páginas de PDF como PNGs e inspecione-as.
   • Use pdftoppm se estiver disponível.
   • Se não estiver disponível, instale o Poppler ou peça ao usuário para revisar a saída localmente.
2. Use reportlab para gerar PDFs ao criar novos documentos.
3. Use pdfplumber (ou pypdf) para extração de texto e verificações rápidas; não confie nele para fidelidade de layout.
4. Após cada atualização significativa, re-renderize as páginas e verifique alinhamento, espaçamento e legibilidade.

Convenções de diretórios temporários e de saída

• Use tmp/pdfs/ para arquivos intermediários; exclua quando terminar.
• Escreva artefatos finais em output/pdf/ ao trabalhar neste repositório.
• Mantenha nomes de arquivo estáveis e descritivos.

Dependências (instale se estiverem faltando)

Prefira uv para gerenciamento de dependências.

Pacotes Python:

uv pip install reportlab pdfplumber pypdf

Se uv não estiver disponível:

python3 -m pip install reportlab pdfplumber pypdf

Ferramentas de sistema (para renderização):

# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

Se a instalação não for possível neste ambiente, informe ao usuário qual dependência está faltando e como instalá-la localmente.

Ambiente

Nenhuma variável de ambiente necessária.

Comando de renderização

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

Expectativas de qualidade

• Mantenha um design visual polido: tipografia, espaçamento, margens e hierarquia de seções consistentes.
• Evite problemas de renderização: texto cortado, elementos sobrepostos, tabelas quebradas, quadrados pretos ou glifos ilegíveis.
• Gráficos, tabelas e imagens devem ser nítidos, alinhados e claramente rotulados.
• Use apenas hífens ASCII. Evite U+2011 (hífen não separável) e outros travessões Unicode.
• Citações e referências devem ser legíveis para humanos; nunca deixe tokens de ferramenta ou strings de espaço reservado.

Verificações finais

• Não entregue até que a inspeção do PNG mais recente mostre zero defeitos visuais ou de formatação.
• Confirme que cabeçalhos/rodapés, numeração de páginas e transições de seção estejam polidos.
• Mantenha arquivos intermediários organizados ou remova-os após a aprovação final.