Communitygithub.com

zhoy0409-debug/scholarflow-skills

Habilidades ScholarFlow de Zhoy: Skills de Agente reutilizáveis para revisão de literatura, escrita acadêmica, figuras, bioinformática e entregáveis de pesquisa.

O que é scholarflow-skills?

O ScholarFlow Skills de Zhoy é um conjunto de habilidades de agente reutilizáveis, projetado para auxiliar pesquisadores e desenvolvedores em tarefas acadêmicas, como revisão de literatura, escrita acadêmica, criação de figuras, bioinformática e produção de entregáveis de pesquisa. A skill de PDF oferece um fluxo de trabalho completo para lidar com documentos PDF, priorizando a revisão visual para garantir layout e formatação precisos, utilizando ferramentas como `pdftoppm` para renderização de páginas e `reportlab` para criação programática de PDFs. Ela suporta os principais sistemas operacionais (macOS, Ubuntu/Debian) e gerencia dependências Python via `uv` ou `pip`, com foco em qualidade visual, consistência tipográfica e validação final por inspeção de PNGs. Esta skill é especialmente útil para ambientes como Claude Code, Cursor ou Codex, onde a automação de tarefas de PDF requer alta fidelidade visual e verificações rigorosas de formatação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add zhoy0409-debug/scholarflow-skills

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade PDF

Quando usar

  • Ler ou revisar conteúdo de PDF onde layout e elementos visuais são importantes.
  • 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 PDF como PNGs e inspecione-as.
    • Use pdftoppm se disponível.
    • Se indisponível, instale 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, renderize novamente as páginas e verifique alinhamento, espaçamento e legibilidade.

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

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

Dependências (instale se ausentes)

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 do 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 design visual polido: tipografia consistente, espaçamento, margens e hierarquia de seções.
  • 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 mais recente do PNG 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 estão polidos.
  • Mantenha arquivos intermediários organizados ou remova-os após aprovação final.

Habilidades Relacionadas