Communitygithub.com

Paper Deep Reading

Convierte artículos de investigación en PDF en notas estructuradas de Obsidian con traducciones automáticas, análisis de figuras y explicaciones de conceptos para un estudio profundo.

¿Qué es Paper Deep Reading?

Esta habilidad transforma un artículo académico en PDF en una nota de Obsidian pulida y didáctica. Procesa el documento página por página, traduce y explica cada párrafo numerado (P01, P02...), inserta las figuras cerca del texto que las menciona y genera notas detalladas para cada figura explicando su tipo, paneles, afirmaciones que respalda y por qué los autores la incluyeron. Incluye soporte para principiantes al explicar conceptos clave, métodos y fórmulas, mantiene un registro de preguntas de aprendizaje (fusionando preguntas repetidas), y puede exportar la nota final a PDF cuando se solicite. Está diseñada para usarse con Obsidian como plataforma principal, pero el flujo de trabajo de renderizado e inspección de PDF es válido en cualquier entorno que pueda visualizar páginas renderizadas. El skill proporciona plantillas de nota, registro de preguntas y notas de figura, además de scripts de validación y exportación, y referencia guías detalladas para cada paso del proceso. El resultado final es un único archivo Markdown sustancial (a menos que el usuario pida varios), con imágenes en una carpeta `assets/figures/` y el PDF exportado en `exports/`.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add Robertmorrisluminousenergy177/paper-deep-reading-skill

Preguntar en tu IA favorita

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

Documentación

Paper Deep Reading (Lectura Profunda de Artículos)

Propósito

Convertir un artículo académico en un artefacto de aprendizaje pulido: una nota principal de Obsidian en Markdown con traducción a nivel de párrafo, figuras colocadas, notas detalladas de figuras, explicaciones para principiantes, soporte de glosario, un registro de preguntas y exportación opcional a PDF.

Usa el skill de PDF o un flujo de trabajo equivalente de renderizado e inspección siempre que la fuente sea un PDF. Para artículos de dos columnas, las páginas renderizadas son la fuente de verdad para el orden de lectura y la ubicación de las figuras.

Flujo de Trabajo Predeterminado

  1. Inspeccionar el PDF fuente: título, autores, secciones, número de páginas, figuras, pies de foto, tablas, referencias a suplementos y cualquier restricción de derechos de autor.
  2. Crear una carpeta de salida con estructura de bóveda que contenga assets/figures/, exports/ y una nota principal en Markdown, a menos que el usuario solicite varias notas.
  3. Traducir y explicar párrafo por párrafo. Numerar los párrafos naturales como P01, P02, etc.; corregir el orden de OCR o extracción comparando con las páginas renderizadas.
  4. Insertar cada figura cerca del párrafo que la utiliza por primera vez. Almacenar las imágenes en assets/figures/ con nombres descriptivos estables.
  5. Para cada figura principal, escribir una nota de figura que explique qué tipo de figura es, qué hace cada panel, qué afirmación respalda, por qué es importante y por qué los autores la incluyeron.
  6. Añadir soporte para principiantes en el primer uso de conceptos clave, métodos, ejes, fórmulas, materiales y mecanismos. Marcar los límites de las afirmaciones: medido, calculado, inferido o propuesto.
  7. Mantener un registro de preguntas para las preguntas de conocimiento. Fusionar preguntas repetidas en la entrada existente más cercana en lugar de duplicar explicaciones largas.
  8. Verificar los enlaces Markdown, las rutas de las figuras, la cobertura de las secciones y si la salida es legible en Obsidian.
  9. Exportar a PDF solo cuando se solicite. Renderizar la nota, inspeccionar visualmente páginas representativas y colocar los PDF finales en exports/.

Referencias Requeridas

Leer solo los archivos de referencia necesarios para la solicitud del usuario:

  • references/reading-workflow.md: flujo de trabajo completo de artículo a nota y controles de calidad.
  • references/figure-note-guide.md: cómo recortar, colocar y explicar figuras.
  • references/beginner-explanation-guide.md: cómo explicar un campo difícil a un principiante sin simplificar en exceso.
  • references/obsidian-note-style.md: estructura de notas, callouts, enlaces y expectativas de CSS.
  • references/question-log-guide.md: cómo mantener el registro de preguntas de aprendizaje y fusionar conceptos repetidos.

Recursos Incluidos

  • assets/note-template.md: estructura inicial para la nota principal del artículo.
  • assets/question-log-template.md: estructura para el registro de preguntas separado.
  • assets/figure-note-template.md: bloque reutilizable de nota de figura.
  • assets/obsidian-css-snippet.css: CSS opcional de Obsidian para callouts y figuras legibles.
  • scripts/validate_note_structure.py: validación ligera de encabezados, imágenes, callouts e IDs de preguntas repetidas.
  • scripts/export_obsidian_note_pdf.js: renderizado de Markdown/Obsidian a PDF mediante Playwright.
  • scripts/extract_pdf_assets.py: ayuda opcional de PyMuPDF para renderizar páginas y extraer imágenes incrustadas.

Estándares de Salida

  • Preferir una única nota Markdown sustancial en lugar de muchos archivos pequeños.
  • Mantener las imágenes cerca del texto que las explica.
  • Escribir notas de figura específicas del artículo, no pies de foto genéricos.
  • Explicar los ejes de los gráficos antes de interpretar las tendencias.
  • Evitar afirmaciones no respaldadas. Decir cuándo un punto es una inferencia del artículo.
  • No incluir públicamente traducciones completas con derechos de autor en repositorios de ejemplo a menos que la licencia de la fuente lo permita.
  • Antes de finalizar, informar la ruta de la nota, el número de figuras, el estado del registro de preguntas y cualquier ruta de exportación.

Skills relacionados