Communitygithub.com

zhoy0409-debug/scholarflow-skills

Habilidades de ScholarFlow de Zhoy: habilidades reutilizables para agentes en revisión de literatura, redacción académica, figuras, bioinformática y entregables de investigación.

¿Qué es scholarflow-skills?

Este conjunto de habilidades (ScholarFlow Skills) proporciona a los agentes de IA (como Claude Code, Cursor, Codex) una guía especializada para manejar documentos PDF, centrándose en tareas de revisión de literatura y redacción académica. La habilidad principal, PDF Skill, instruye al agente sobre cómo leer, crear y validar PDFs con un énfasis en la fidelidad del diseño visual (tipografía, imágenes, gráficos) que es crucial para las entregas académicas. Utiliza herramientas de sistema como 'pdftoppm' para previsualizar páginas como imágenes PNG y bibliotecas de Python como 'reportlab' (generación) y 'pdfplumber'/'pypdf' (extracción de texto). El flujo de trabajo recomienda usar 'uv' para la gestión de dependencias, establecer directorios para archivos temporales (tmp/pdfs/) y de salida (output/pdf/), y realizar verificaciones visuales antes de la entrega final para asegurar que no haya defectos de formato, cumpliendo con estándares académicos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add zhoy0409-debug/scholarflow-skills

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad PDF

Cuándo usarla

  • Leer o revisar contenido PDF donde el diseño y los elementos visuales importen.
  • Crear PDFs de forma programática con formato confiable.
  • Validar la representación final antes de la entrega.

Flujo de trabajo

  1. Prefiere revisión visual: renderiza páginas PDF a PNG e inspecciónalas.
    • Usa pdftoppm si está disponible.
    • Si no está disponible, instala Poppler o pídele al usuario que revise el resultado localmente.
  2. Usa reportlab para generar PDFs al crear nuevos documentos.
  3. Usa pdfplumber (o pypdf) para extraer texto y realizar verificaciones rápidas; no confíes en él para la fidelidad del diseño.
  4. Después de cada actualización significativa, vuelve a renderizar las páginas y verifica la alineación, el espaciado y la legibilidad.

Convenciones de archivos temporales y salida

  • Usa tmp/pdfs/ para archivos intermedios; elimínalos al terminar.
  • Escribe los artefactos finales en output/pdf/ cuando trabajes en este repositorio.
  • Mantén los nombres de archivo estables y descriptivos.

Dependencias (instalar si faltan)

Prefiere uv para la gestión de dependencias.

Paquetes de Python:

uv pip install reportlab pdfplumber pypdf

Si uv no está disponible:

python3 -m pip install reportlab pdfplumber pypdf

Herramientas del sistema (para renderizado):

# macOS (Homebrew)
brew install poppler

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

Si la instalación no es posible en este entorno, indica al usuario qué dependencia falta y cómo instalarla localmente.

Entorno

No se requieren variables de entorno.

Comando de renderizado

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

Expectativas de calidad

  • Mantén un diseño visual pulido: tipografía consistente, espaciado, márgenes y jerarquía de secciones.
  • Evita problemas de renderizado: texto cortado, elementos superpuestos, tablas rotas, cuadrados negros o glifos ilegibles.
  • Los gráficos, tablas e imágenes deben ser nítidos, alineados y claramente etiquetados.
  • Usa solo guiones ASCII. Evita U+2011 (guión de no separación) y otros guiones Unicode.
  • Las citas y referencias deben ser legibles para humanos; nunca dejes tokens de herramientas o cadenas de marcador de posición.

Verificaciones finales

  • No entregues hasta que la última inspección PNG muestre cero defectos visuales o de formato.
  • Confirma que los encabezados/pies de página, la numeración de páginas y las transiciones entre secciones se vean pulidos.
  • Mantén los archivos intermedios organizados o elimínalos después de la aprobación final.

Skills relacionados