Communitygithub.com

Jihoon950/paper-to-research-video

Produce un video de investigación pulido de 80 a 100 segundos a partir de un artículo académico o preprint, con afirmaciones respaldadas por el artículo, escenas animadas personalizadas, subtítulos y un MP4 verificado.

¿Qué es paper-to-research-video?

Esta habilidad permite transformar artículos académicos o preprints en videos de investigación profesionales de aproximadamente 90 segundos. Está diseñada para agentes de IA que necesitan comunicar visualmente los hallazgos de un artículo, incluyendo el problema, la solución propuesta, los experimentos y los resultados. Es compatible con plataformas como Claude Code, Cursor y Codex, y utiliza herramientas nativas de código como Remotion y FFmpeg para la producción. El proceso incluye la lectura completa del artículo, la creación de un libro de reclamaciones con referencias precisas, la planificación de un guion gráfico escena por escena, y la producción y verificación del video final con subtítulos y metadatos de verificación. La habilidad asegura que cada afirmación cuantitativa o causal tenga su fuente exacta en el artículo, evitando interpretaciones erróneas o la invención de datos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jihoon950/paper-to-research-video/tree/HEAD/skills/paper-to-research-video

Preguntar en tu IA favorita

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

Documentación

Papel a Video de Investigación

Crear una película que permita a un nuevo espectador entender el problema, lo que se construyó o propuso, lo que se probó y lo que la evidencia realmente muestra en aproximadamente 90 segundos. Tratar el artículo proporcionado como la fuente de evidencia, no como una presentación de diapositivas para recorrer.

Comenzar con la fuente

  1. Leer el artículo completo, incluyendo pies de figura, métodos, unidades, líneas base, limitaciones y suplemento cuando se proporcione. Para una URL o DOI, obtener el artículo referenciado. Para un PDF local, extraer texto e inspeccionar las páginas reales de figuras; OCR páginas escaneadas cuando sea necesario. No inferir resultados solo del resumen.
  2. Hacer un libro de reclamaciones compacto: cada afirmación cuantitativa o causal en pantalla necesita la ubicación exacta de la fuente (página, figura, tabla o elemento suplementario), definición de métrica, condición de comparación y cualquier calificación. Separar las mediciones reportadas, la interpretación de los autores y tu propia ilustración explicativa. Si un resultado clave es ambiguo, inspeccionar la fuente nuevamente y acotar la afirmación.
  3. Inventariar las figuras fuente, tablas, videos, fotos, logotipos, grabaciones de pantalla y derechos de uso. Preferir las figuras/datos propios del artículo o diagramas generados originales. Si una demostración de sistema real solicitada no tiene grabación, construir una ilustración explícitamente etiquetada; no presentarla como metraje observado. No subir material fuente privado o no publicado a un servicio externo sin autorización.

Dirigir la película

Escribir una lista de tomas escena por escena con código de tiempo, un mensaje por toma, la acción visual, qué se mueve a dónde, transición, subtítulos/narración, IDs de afirmaciones fuente y procedencia del medio. Usar la forma narrativa que se ajuste al artículo; una ruta común es apuestas → sistema o idea → comparación controlada → mecanismo → resultado y límite. Colocar el título del artículo, autores e institución al inicio cuando se conozcan. Mostrar el sistema probado antes de mostrar su falla o beneficio cuando ese contexto sea necesario.

Apuntar a 90 segundos por defecto (80–100 es aceptable); ajustar cuando el usuario especifique una duración diferente. Usar tiempo en pantalla para la configuración experimental y denominadores, no solo el número más grande. Si una comparación es condicional, identificar el estado en cada lado y la línea base; no convertir mediciones de condición fija separadas en evidencia de un controlador en línea medido. Dar al fotograma de cierre una conclusión y limitación precisas.

Planificar el lenguaje visual a partir de la ciencia. Animar diagramas, gráficos medidos, trazas y metraje grabado autorizado de diferentes maneras para que el público pueda distinguirlos. El video real o la salida de terminal deben conservar la procedencia; las repeticiones, mecanismos ilustrativos y paneles simulados deben estar visiblemente marcados. Sin métrica inventada, flujo de tokens, traza de utilización, registro de fallos o transición no medida. Para obtener orientación detallada sobre narrativa y etiquetado, leer editorial-guidance.md.

Producir y verificar

Crear una carpeta de producción de trabajo junto al artículo o en la ubicación elegida por el usuario. Guardar allí el libro de reclamaciones y la lista de tomas, luego implementar la película con una herramienta de línea de tiempo nativa de código adecuada (Remotion y FFmpeg cuando estén disponibles; elegir otra herramienta si se adapta mejor al entorno). El inicio de Remotion incluido es un andamio ejecutable, no un estilo visual para dejar intacto: reemplazar su texto de muestra y construir tomas y transiciones específicas del artículo. Su manifiesto de película y scripts/validate_film.py proporcionan una verificación reutilizable de evidencia/código de tiempo. No copiar las afirmaciones sintéticas del fixture del inicio en la película del usuario.

Renderizar algunas imágenes representativas temprano para inspeccionar jerarquía, etiquetas, derechos de imagen y contraste en el tamaño de visualización objetivo. Luego renderizar el video completo, inspeccionar apertura/medio/cierre y transiciones, y corregir texto recortado, gráficos pequeños, leyendas ilegibles o saltos abruptos en la historia. Entregar un MP4, proyecto fuente, libro de reclamaciones-a-fuente, lista de tomas y archivo de subtítulos (o subtítulos en pantalla si se solicita). Por defecto 1920×1080, 30 fps, H.264 y sin audio cuando el usuario no haya elegido audio; agregar narración/música solo cuando se solicite o el contexto claramente lo requiera. Respetar el idioma del usuario.

Ejecutar <skill-dir>/scripts/validate_film.py path/to/film.json --release cuando se use el manifiesto de inicio, y <skill-dir>/scripts/export_srt.py path/to/film.json path/to/captions.srt para subtítulos a nivel de escena. Luego ejecutar <skill-dir>/scripts/verify_video.py path/to/final.mp4 --target-seconds 90 cuando ffprobe y ffmpeg estén disponibles. Estas comprobaciones no reemplazan la revisión visual y científica. Indicar qué se midió, qué se reconstruyó o ilustró, y qué metraje no estuvo disponible. No considerar un renderizado como terminado si su duración, decodificación, subtítulos o afirmaciones científicas centrales no se han verificado.

Skills relacionados