Communitygithub.com

vibe-science-video

Crea o refina videos de conocimiento tipo Vibe basados en artículos, mecanismos científicos o preguntas de conocimiento, entregando videos reproducibles, proyectos editables y materiales de publicación. Ideal para tareas que requieren aperturas atractivas, animaciones 2D/3D explicativas, sincronización con BGM, ritmo de subtítulos, transiciones elegantes y revisión audiovisual; compatible desde la selección del tema hasta el producto final, así como con la corrección de videos existentes por puntos de tiempo.

¿Qué es vibe-science-video?

Esta habilidad está diseñada para que agentes de IA (como Claude Code, Cursor o Codex) automaticen la creación y refinamiento de videos educativos de alta calidad, similares a los de 'Vibe Science'. Su objetivo principal es transformar contenido científico o técnico (artículos, mecanismos, preguntas) en animaciones atractivas que los espectadores quieran ver y entender. La habilidad va más allá de la simple generación de código; establece un flujo de trabajo completo que incluye desde la investigación y estructuración narrativa (basada en referencias como 'story-and-evidence.md') hasta la producción, revisión y empaquetado final del video. Soporta múltiples plataformas y entornos, con un fuerte énfasis en la verificabilidad y la calidad: cada etapa produce artefactos comprobables (guiones gráficos, registros de hechos, listas de verificación de QA) y el proceso está diseñado para construir una línea base de calidad cercana a la publicación desde el primer intento. La habilidad maneja tanto proyectos nuevos como la modificación de videos existentes basándose en marcas de tiempo y comentarios del usuario, y proporciona herramientas para análisis de música, sincronización y verificación de medios. No depende de modelos de IA específicos, GPU adicionales u otras habilidades para funcionar, aunque puede combinarse con habilidades de Remotion si están disponibles. Su núcleo es 'vibe-science-video', que ofrece un enfoque estructurado y profesional para la producción de videos educativos animados.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/S-Fan-ZJU/vibe-science-video/tree/HEAD/skills/vibe-science-video

Preguntar en tu IA favorita

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

Documentación

Vibe Science Video

Convierte el conocimiento en animaciones que los espectadores quieran ver, puedan entender la causalidad y sean viables para la reproducción real. El objetivo es establecer una línea base de calidad cercana a la publicación desde el primer intento, y luego corregir problemas con evidencia verificable. No prometas que cualquier tema se generará exitosamente a la primera, ni trates el código fuente generado como un video ya entregado.

Primero, determina dónde se encuentra la tarea

  • Nuevo proyecto: Lee Historia y evidencia y Dirección visual. Crea el brief, el registro de hechos y el guion gráfico.
  • Continuar un proyecto existente: Primero busca la lista de entrega actual, la pista de audio final, la línea de tiempo y los últimos comentarios del usuario. Conserva las tomas satisfactorias y las salidas antiguas; no sobrescribas la versión final con borradores históricos.
  • Corregir un problema específico: Lee la sección de corrección de Producción, revisión y corrección. Registra la marca de tiempo, el objeto, el fenómeno y decide si cambiar la pista de audio, volver a renderizar o reorganizar todo el video.
  • Solo para portada o texto: Lee Materiales de publicación. No inicies una regrabación innecesaria del video.

Al crear un nuevo video, rediseñar la dirección visual o agregar/reemplazar material gráfico, primero verifica la biblioteca de modelos existente del proyecto antes de decidir modelar o descargar. Lee assets/models/README.md, inventory.json y las vistas previas existentes del proyecto. Si no hay un inventario, usa la herramienta de inventario de solo lectura del Flujo de reutilización de modelos para encontrar archivos reales. Decide la reutilización según la necesidad del objeto científico, la toma y el estilo confirmado, y regístralo en el Plan de activos (archivos y compensaciones). Si solo se modifican subtítulos, mezcla o texto de publicación, no es necesario volver a escanear la biblioteca de modelos.

Las elecciones actuales del usuario tienen prioridad sobre los siguientes valores predeterminados: audiencia general; subtítulos en chino + BGM + efectos de sonido clave, sin narración; duración determinada por la necesidad de explicación, pudiendo planificarse de 2 a 4 minutos; formato horizontal 16:9; vista previa en baja resolución, pudiendo entregar master 4K60 y versión de reproducción 1080p60. Si el presupuesto, hardware o tema no son adecuados, propón compensaciones específicas; no uses 4K, 60 fps o 3D como sustituto de la calidad.

Solo haz preguntas complementarias si no se puede obtener la información de los materiales existentes y si cambiará el resultado. Si el tema ya está decidido, no forces una reselección. Si el usuario solicita ver una muestra primero, entrégala en ese punto. Si el usuario autoriza la finalización continua, continúa después de una revisión de calidad interna, sin solicitar permiso repetidamente en cada etapa. La autorización de producción no incluye automáticamente la publicación pública o la modificación de cuentas externas.

Restricciones centrales de este flujo

  1. Que tenga sentido desde el primer vistazo. El primer segundo debe mostrar un objeto directamente relacionado con el tema, y los primeros segundos deben mostrar una acción clara. Plantea la pregunta a través de la situación humana, un fenómeno contradictorio o una contradicción observable; el nombre técnico aparece después.
  2. Cada segmento avanza un concepto. Explica el mecanismo como 'problema → cambio de condición → comportamiento del objeto → resultado visible'; responde antes de plantear la siguiente pregunta. No sustituyas las respuestas con una serie de preguntas.
  3. La metáfora visual no puede cambiar el mecanismo. El registro de hechos documenta el objeto, condición, causalidad, fuente, simplificación y el significado que no se puede dibujar. Diferentes estrategias de investigación se distinguen por capítulos o redacción; no se fusionan en un sistema único.
  4. El clímax debe coincidir con el fotograma de resultado. Cuando llegue el momento del ataque musical, el espectador ya debe ver el contacto, la apertura, la separación de la membrana o el estado iluminado, no la animación comenzando a moverse lentamente.
  5. Ser compacto no significa eliminar texto. Primero elimina las entradas lentas y las esperas vacías después de leer; las acciones complejas aún necesitan tiempo de observación. Los subtítulos, acciones y SFX se exportan desde la misma línea de tiempo.
  6. La sofisticación sirve a la comprensión. Prioriza el sujeto claro, la textura, la jerarquía, la dirección y el contacto visible sobre partículas irrelevantes. Los mecanismos que requieren oclusión frontal/trasera, inserción o envoltura deben usar estructuras espaciales verificables.
  7. La transición también es parte del guion gráfico. Especifica claramente el objeto de la escena anterior, la continuidad de la oclusión o forma, el fotograma de intercambio y el punto de aterrizaje de la siguiente escena. No agregues fundidos genéricos al finalizar todo el video.
  8. Revisa el archivo final. Studio, PNG, MP4 codificado y la vista previa de carga pueden ser diferentes. Registra por separado la decodificación completa, la verificación de fotogramas seleccionados, la reproducción continua y la escucha real; no pueden sustituirse entre sí.

Flujo de entrega ejecutable

EtapaResultados comprobables que deben generarseCriterio para el siguiente paso
1. Recibir entradabrief: problema, audiencia, materiales, sonido, formato, alcance, directorio raíz del proyecto¿Qué debe entender el espectador al final? ¿Existen fuentes claras y materiales necesarios?
2. Contenido y narrativaRegistro de hechos, línea argumental de una frase, cadena de preguntas, diseño de los primeros 15 segundosLas conclusiones clave son trazables; la apertura tiene acción y promesa; las preguntas pueden responderse
3. Guion gráfico audiovisualGuion gráfico, Plan de activos, identidad del BGM final, cues candidatos, plan de transicionesEl modelo coincide con la estructura científica; los verbos clave son visibles; la jerarquía fuerte/débil es clara
4. Segmento de muestra de calidadApertura + la toma del mecanismo más difícil + un corto real codificado que represente una transiciónLos activos principales alcanzan la calidad final; las acciones clave y el sonido están alineados de verdad
5. Producción completaProyecto editable, línea de tiempo unificada, subtítulos, eventos de sonido, registro de activosCada capítulo está claro, las tomas fluyen naturalmente, los subtítulos no tienen esperas vacías ni lectura apresurada
6. Salida y correcciónVideo completo, QA correspondiente, versiones revisadas y diferenciasArchivo, imagen, sonido e identidad de versión pasan la revisión por separado
7. Paquete de publicaciónPortada, título/descripción/etiquetas, lista de entrega, instrucciones de reproducciónLa promesa externa coincide con el contenido; el recorte para la plataforma actual y la selección de archivos son correctos

Lee las referencias correspondientes según la necesidad de la tarea:

  • Historia y evidencia: Conversión de artículo a guion, gancho, cadena de preguntas, duración de subtítulos, ejemplo narrativo completo.
  • Dirección visual: Sistema de diseño, selección de activos, material y espacio, receta de acción, transiciones y verificación de clipping.
  • Biblioteca de modelos y reutilización entre diálogos: Descubre primero los activos locales, verifica estructura, piezas, tamaño y licencia, luego diseña la toma; cómo establecer un punto de entrada de descubrimiento para proyectos nuevos o existentes.
  • Música y tiempo: BGM predeterminado del caso, reemplazo personalizado, verificación de beats, efectos de sonido y mezcla, alineación audiovisual.
  • Producción, revisión y corrección: Implementación reproducible, presupuesto de renderizado, verificación del archivo final, corrección localizada, estructura de entrega.
  • Materiales de publicación: Composición de portada, formato de plataforma, título/descripción, fuentes de activos y paquete de publicación.
  • Caso real y corrección de fallos: Resultado final de 'Convertir bacterias en medicina', comentarios, razones de corrección y límites de aplicabilidad.
  • Herramientas portátiles: Comandos reales y limitaciones para analizar BGM, verificar línea de tiempo, decodificación completa y extracción de fotogramas.

Verificación inicial e inicio del proyecto

Al crear un nuevo proyecto, puedes copiar el starter de Remotion + Three.js al proyecto del usuario, luego seguir sus instrucciones para instalar, previsualizar y renderizar. No modifiques directamente las plantillas del skill instalado. Es un experimento de acción espacial de doble condición de aproximadamente 12 segundos, utilizado para verificar el entorno, el movimiento, el sonido y el enlace de exportación; no es una introducción fija que convierta automáticamente todos los temas en videos completos.

El BGM de referencia incluido en el paquete y los datos de fuente/análisis proporcionan una entrada musical predeterminada; se debe priorizar la música existente del usuario. El starter admite archivos personalizados; después de reemplazarlos, se deben actualizar el análisis y los momentos de eventos. La timeline.json de la plantilla es un ejemplo de estructura independiente, no una tabla de beats fija para la música de referencia o el starter.

En proyectos reales, ejecuta el análisis de música, la verificación de línea de tiempo y la verificación de medios finales de tools.md. Lee las advertencias del informe y combínalas con el juicio visual; no elimines condiciones científicas ni desactives advertencias solo para que el script se vuelva verde. Las herramientas no pueden juzgar automáticamente si el mecanismo es correcto, si el resultado realmente aparece en el fotograma especificado o si el sonido de alerta se destaca auditivamente; todo esto requiere una revisión visual y auditiva adicional.

Las herramientas y plantillas relevantes deben basarse en las instrucciones reales del repositorio; no adivines nuevos momentos musicales a partir de los valores de los casos de ejemplo. Incluso sin un modelo de imagen específico, GPU o skill adicional, se puede ejecutar este flujo con las herramientas disponibles. Si ya existe un proyecto de Remotion, prioriza el uso de su versión bloqueada; si necesitas invocar su nueva API, consulta la documentación oficial actual. Si ya existe un skill oficial de Remotion, se puede usar en combinación; este skill no depende de otro skill específico para entender el flujo central.

Al comenzar la producción, primero completa estos juicios

Narrativa: Escribe una razón específica para ver; elige de 3 a 5 preguntas que puedan formar la respuesta visible más clara como punto de partida, en lugar de requisitos fijos. Decide cuál es la escena de mayor revelación y qué segmentos necesitan una explicación tranquila.

Activos: Primero, haz un inventario de los candidatos locales; registra la correspondencia entre cada objeto visible y el hecho. Reutiliza cuando sea apropiado; si el objeto científico no coincide, faltan piezas necesarias o el efecto visual no es adecuado, explica el motivo y elige entre 2D, modificación o material nuevo. El hecho de que una cadena esté coloreada no significa que la cadena pueda moverse de forma independiente; un modelo existente no significa que la animación del mecanismo esté lista. Primero, lleva una toma representativa al nivel de finalización deseado, luego generaliza los materiales y las acciones.

Música: Puedes elegir el BGM de caso o usar una pista personalizada del usuario. Primero, identifica el archivo de entrada real, su duración y versión; después de editar, hacer loop o cambiar la velocidad, vuelve a analizar la música final. La detección de beats es solo candidata; se requiere confirmación con forma de onda y escucha real.

Ingeniería: Archiva la entrada, los activos, el código fuente, la salida y el QA dentro del proyecto; el estado del mismo fotograma debe ser reproducible. Usa semillas aleatorias explícitas y evita que la animación dependa del reloj real, el historial de reproducción o recursos asíncronos incompletos.

Tomas de riesgo: Primero, prueba el proceso completo de la acción más difícil. Las llaves dobles deben tener agujeros reales y espacio de barrido; la liberación debe ocurrir primero con carga interna y luego separación; el envoltorio debe ser continuo desde el devorador hacia el objetivo. El mecanismo específico se basa en los materiales de esta ocasión.

Definición de finalización

Usa la Lista de verificación de QA para marcar cada elemento como 'Verificado / No verificado / No aplicable' con evidencia; no completes el estado de finalización sin ejecutar. La entrega final debe incluir al menos: video reproducible, proyecto editable, guion/subtítulos finales, registro de música y cues, portada y texto (dentro del alcance de la tarea), método de vista previa/renderizado disponible, fuentes de activos y limitaciones conocidas.

Si el entorno no puede renderizar realmente, especifica claramente hasta qué paso se ha llegado, qué comando o recurso está bloqueando, y conserva el proyecto ejecutable; no escribas un enlace de vista previa o 'renderizable en teoría' como si se hubiera generado un MP4. El agrado del usuario por el trabajo, la verificación automática y los datos de visualización de la plataforma son evidencias diferentes; no conviertas automáticamente ninguna de ellas en 'retención garantizada'.

Skills relacionados