Communitygithub.com

Firepanda415/skills-de-investigacion-y-biblioteca-cientifica

Planificar, redactar guiones, animar y revisar videos explicativos narrados de artículos de investigación, repositorios de código o métodos científicos, con locución y subtítulos incrustados.

¿Qué es skills-de-investigacion-y-biblioteca-cientifica?

Esta habilidad permite a un agente de IA crear videos explicativos narrados de alta calidad a partir de documentos de investigación científica o repositorios de código. Está diseñada para producir contenido riguroso donde cada afirmación, número y curva trazada se puede rastrear hasta su fuente original, tratando el video como una publicación científica en sí misma. Es compatible con cualquier plataforma de agente que acepte definiciones de habilidades en markdown (como Claude Code, Cursor o Codex) y su flujo de trabajo se basa en una tubería de producción modular que incluye síntesis de voz, sincronización de subtítulos y renderizado de animaciones programáticas. La habilidad guía al agente desde la lectura y mapeo de reclamaciones del material fuente, pasando por la escritura de un guion conciso y la animación de elementos visuales (como gráficos, ecuaciones y diagramas), hasta una fase de revisión obligatoria antes de la entrega. Su utilidad radica en automatizar la creación de resúmenes animados, abstracts animados o revisiones de videos académicos con un control de calidad riguroso sobre la veracidad de los datos y la presentación visual.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Firepanda415/research-and-scientific-lib-skills/tree/HEAD/plugins/research-skills/skills/research-explainer-animation

Preguntar en tu IA favorita

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

Documentación

Animación explicativa de investigación

Crea un video narrado corto que explique un trabajo de investigación a un espectador con formación científica que no lo haya leído. Trata el video como una publicación sobre el trabajo. Cada afirmación, número, ecuación y curva trazada debe poder rastrearse hasta la fuente, y el video renderizado debe ser inspeccionado antes de la entrega.

Preparar a partir de la fuente

  1. Lee la fuente completa. Para un artículo, incluye las tablas, los pies de figura y los apéndices que respaldan los números que citarás. Para un repositorio sin artículo, lee su README, documentación, ejemplos y pruebas, y explica solo el comportamiento que el código respalda.
  2. Escribe un mapa de afirmaciones antes del guion. Cubre el problema, por qué es difícil, la idea clave, qué es nuevo en relación con trabajos previos citados, cómo funciona el método bloque por bloque, los resultados con sus condiciones y las limitaciones declaradas. Registra la tabla, sección o archivo detrás de cada número, y marca los números derivados, como un porcentaje calculado a partir de dos entradas de tabla, como derivados.
  3. Traza datos reales. Busca los datos y el código de los autores, incluidos los repositorios nombrados en el artículo y las copias locales del usuario. Antes de usar una cantidad trazada, rastréala hasta sus datos y recalcula cualquier valor derivado o ajuste a partir de esos datos. Compara los valores rastreados o recalculados con los reportados. Vuelve a ejecutar una simulación o experimento costoso solo con la aprobación del usuario. Etiqueta las entradas esquemáticas como ilustrativas.
  4. Encuentra la tubería de animación existente y el módulo de estilo del proyecto de destino y reutilízalos, para que un nuevo video coincida con los anteriores. Sin una tubería existente, construye una siguiendo la arquitectura en tubería de producción, y trata sus nombres de funciones como sugerencias. Toma las rutas, el entorno y los comandos de compilación, y cómo los videos se adjuntan a una página, de la guía del proyecto cuando los tenga. Usa el entorno que el proyecto declara. Cuando no declare ninguno, usa las herramientas instaladas que satisfagan las necesidades de la tubería, registra sus rutas y versiones junto con las fuentes del video, e informa al usuario qué necesita instalar, incluida cualquier descarga de pesos de síntesis de voz por primera vez.

Redactar la narración

  • Apunta al video más corto que transmita el problema, la idea, el método, la evidencia y el alcance. Un explicador de artículo completo generalmente necesita de tres a cuatro minutos y medio, alrededor de 450 a 600 palabras habladas en inglés. Un resumen animado o el límite de duración de un evento establece un objetivo más corto.
  • Sigue el mapa de afirmaciones: problema, obstáculo, idea, mecanismo, evidencia, comparación y compensaciones, y luego una conclusión. Reconoce el trabajo previo sobre el que se basa el método y expresa la contribución en los propios términos del artículo. Traslada las precauciones y condiciones del artículo a la narración.
  • La narración y el texto en pantalla son prosa duradera. Aplica research-writing-style, incluida su revisión obligatoria, antes de la síntesis.
  • Divide el guion en segmentos de una a cuatro oraciones. Cada oración tiene texto de subtítulo y, cuando sea necesario, texto hablado separado que deletrea acrónimos, lee símbolos en voz alta o anula una pronunciación.
  • Usa la voz que el usuario eligió para videos anteriores. Sin una elección registrada, sintetiza un pasaje corto con algunas voces candidatas, escribe las muestras en archivos de audio, proporciona al usuario sus rutas y deja que el usuario elija. Registra la elección con la configuración de narración o en las notas del proyecto, para que los videos posteriores la reutilicen.

Lee tubería de producción para conocer la arquitectura de síntesis, sincronización, renderizado, subtítulos y codificación, y sus modos de fallo conocidos. Lee estilo de la casa para conocer el estilo visual y de audio predeterminado.

Animar

  • Dale a cada oración una idea visual y comienza su animación cuando comience esa oración, usando tiempos medidos a partir del audio sintetizado.
  • Mantén los roles de color, la tipografía, las etiquetas de sección, la tarjeta de título, la tarjeta de cierre y la tira de subtítulos consistentes en todos los videos.
  • Compon las ecuaciones con un compositor matemático y dibuja gráficos a partir de datos. Muestra unidades, incertidumbre con su estadística y signos de resta verdaderos.
  • Construye un póster fijo separado con elementos grandes que siga siendo legible en el ancho de una miniatura.

Verificar antes de la entrega

Estas comprobaciones son obligatorias. Un video narrado puede fallar en silencio de maneras que un renderizado exitoso no revela.

  • Inspecciona el renderizado completo como hojas de contacto, por ejemplo un fotograma cada cuatro o cinco segundos, e inspecciona los fotogramas densos a tamaño completo. Busca texto recortado o superpuesto, etiquetas dibujadas sobre ejes, fórmulas incompletas como barras de fracción faltantes y objetos que se separan de los datos que representan durante el movimiento.
  • Confirma que cada línea de subtítulo tenga narración debajo y que los inicios de los subtítulos se alineen con los inicios del habla.
  • Compara cada número en pantalla y en la narración con el mapa de afirmaciones.
  • Cuando el video esté incrustado en un sitio, compila el sitio, ejecuta sus pruebas y verifica la página y el reproductor en anchos de escritorio y teléfono con las herramientas del navegador que proporciona el anfitrión, por ejemplo, capturas de pantalla sin cabeza en ambos anchos. Sin dichas herramientas, pide al usuario que verifique esos anchos.
  • A menos que el anfitrión permita que el agente escuche el audio, pide al usuario que escuche la pronunciación y el ritmo, y nombra las palabras con mayor riesgo.

Entregar y revisar

Entrega el video terminado con su ruta y duración, resume su contenido y fuentes de datos, y enumera lo que el usuario aún debe verificar de oído o de vista. Para un comentario con marca de tiempo, localiza el fotograma, corrige la causa en lugar del fotograma individual y busca en el resto del video, y en otros videos creados con la misma tubería, el mismo defecto.

Skills relacionados