Peytontalismanic424/paper-share-skills

Descarga el código fuente TeX (e-print tar.gz) de un artículo de arXiv desde una URL o ID, y lo descomprime en paper_src/. Úsalo SIEMPRE que la entrada de un pipeline sea un enlace de arXiv y se prefiera el código fuente TeX sobre el PDF.

¿Qué es paper-share-skills?

Esta habilidad descarga el código fuente TeX de un artículo de arXiv a partir de una URL o ID desnudo, y lo descomprime en el directorio `paper_src/`. Es el primer paso requerido cuando la entrada es un enlace de arXiv y se necesita el código fuente TeX (no solo el PDF) para pipelines posteriores, como `paper-to-beamer`, `paper-to-bilibili` o `paper-venue-discovery`. La habilidad soporta URLs de arXiv (abs, pdf, e-print, export.arxiv.org) e IDs como `2509.07996v4`. Extrae el archivo e-print (tar.gz) y lo descomprime, rechazando miembros no seguros. Si el artículo solo tiene PDF, descarga el PDF en su lugar. La salida final incluye una línea `TEX_SOURCES:` o `PDF_ONLY:` que los consumidores deben usar para identificar los archivos. Es idempotente: si se ejecuta de nuevo con el mismo ID, omite la descarga a menos que se use `--force`. En caso de error, devuelve un código de salida distinto de cero y un mensaje `ERROR:` en stderr.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/Peytontalismanic424/paper-share-skills/tree/HEAD/paper-download-arxiv-paper-source

Documentación

Descargar Código Fuente TeX de Artículo de arXiv

Dado un enlace de arXiv o un ID desnudo de arXiv, descarga el código fuente TeX del artículo desde https://arxiv.org/e-print/<id> y lo descomprime para pipelines posteriores. Este es el primer paso necesario cuando el usuario proporciona un enlace de arXiv y se debe alimentar el pipeline con el código fuente TeX (no solo el PDF) — el código fuente TeX conserva tablas, ecuaciones y figuras exactamente y omite MinerU.

Cuándo usarlo

El usuario proporciona una URL de arXiv (arxiv.org/abs/…, arxiv.org/pdf/…, arxiv.org/e-print/…, export.arxiv.org/…) o un ID desnudo (2509.07996, 2509.07996v4) como entrada de cualquier pipeline de artículos.
Una habilidad consumidora necesita el código fuente del artículo en disco (paper_src/) pero solo tiene una referencia de arXiv.

Invocación

uv run --no-project python \
  "<SKILLS_DIR>/paper-download-arxiv-paper-source/scripts/download_source.py" \
  "<arxiv-url|arxiv-id>" [--output DIR] [--force]

--output por defecto es el directorio de trabajo actual de la sesión.
--force vuelve a descargar incluso si el archivo ya existe.

Contrato de salida

En el directorio de salida:

arXiv-<id>.tar.gz — archivo e-print descargado (gzip/tar).
paper_src/ — código fuente TeX extraído (aplanado si el archivo está envuelto en un único directorio raíz; los miembros no seguros son rechazados).
Envíos solo PDF (sin código fuente TeX en arXiv): arXiv-<id>.pdf en su lugar.
Envíos de un solo archivo TeX: arXiv-<id>.tex en su lugar.

En caso de éxito, stdout termina con TEX_SOURCES: <rutas relativas separadas por comas> (o PDF_ONLY: <ruta absoluta del pdf>). Consume estas líneas — nunca adivines nombres de archivo.

Idempotencia

Ejecutar de nuevo con el mismo ID en el mismo directorio de salida omite la descarga (stdout comienza con SKIP) a menos que se use --force; la extracción aún se verifica.

Fallo

Código de salida distinto de cero + mensaje ERROR: en stderr (fallo de análisis, fallo de red, cuerpo vacío, payload inesperado, miembro de archivo no seguro, sin .tex en el archivo). El pipeline debe detenerse e informar — nunca caer silenciosamente al PDF.

Nota de alternativa

Si el script informa PDF_ONLY: <ruta>, el artículo no tiene código fuente TeX en arXiv. Los consumidores usan entonces ese PDF con la ruta de MinerU (por ejemplo, la PUERTA DE DECISIÓN de la Fase 2 de paper-to-beamer) en lugar de leer TeX.

Consumido por

paper-to-beamer Fase 1 (entrada de enlace/ID de arXiv)
paper-to-bilibili modo diapositivas (entradas con arxiv_id, sin fuente local)
paper-venue-discovery paso 1 (obtener fuente cuando solo se da un enlace)

Habilidades relacionadas

skill://paper-to-beamer
skill://paper-to-bilibili
skill://paper-venue-discovery
skill://paper-to-beamer-workflow
skill://paper-bilibili-multi-part-series-upload
skill://paper-bilibili-series-upload