Communitygithub.com

lzcjsyr/Book2Video

Flujo de trabajo general para la creación de composiciones de video HyperFrames personalizadas de cualquier longitud o formato: piezas largas o multi-escena, reels de marca / sizzle, montajes, tarjetas de título, bucles estáticos y composiciones libres. Es independiente de la entrada y la duración. Si un flujo de trabajo especializado encaja claramente con la entrada (un producto comercializado, un sitio web, un explicador de temas, un PR de GitHub, metraje existente, un motion graphic corto o un puerto de Remotion), prefiera ese (ver /hyperframes); use este solo como alternativa general cuando ninguno encaje.

¿Qué es Book2Video?

Este skill es el flujo de trabajo general (fallback) para crear composiciones de video HyperFrames personalizadas, utilizado cuando ningún flujo especializado (como videos de lanzamiento de productos, de sitios web, o explicadores) es adecuado. Sigue un proceso estructurado que comienza con la definición del sistema de diseño (a través de hyperframes-creative) y la expansión del prompt, para luego planificar la composición, ritmo y temporización. Una regla clave es construir primero el estado final estático de cada elemento en su momento más visible (Layout Before Animation), antes de añadir cualquier movimiento con GSAP. El skill gestiona todo el pipeline de producción de video, incluyendo la generación y sincronización de audio (TTS, BGM, SFX) a través de un motor compartido en hyperframes-media, y la delegación de tareas específicas (animación, tipografía cinética, datos, transiciones) a módulos especializados. Está diseñado para su uso con agentes de IA como Claude Code, Cursor o Codex, y se apoya en referencias detalladas para garantizar resultados visualmente profesionales y coherentes.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lzcjsyr/Book2Video/tree/HEAD/skills/step4/general-video

Preguntar en tu IA favorita

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

Documentación

media-use: Antes de obtener audio/imágenes, ejecute /media-use para resolver BGM/SFX/imágenes del catálogo de HeyGen. Ejecute --adopt primero para registrar activos existentes. Consulte el skill /media-use.

general-video — flujo de trabajo de video general

Confirme la ruta antes de construir. Este es el fallback para la creación de composiciones personalizadas. Si la entrada claramente se ajusta a un flujo de trabajo especializado, prefiera ese: producto comercializado → /product-launch-video; sitio web general → /website-to-video; explicador de temas → /faceless-explainer; PR de GitHub → /pr-to-video; metraje existente → /embedded-captions · /talking-head-recut; motion graphic corto sin narración → /motion-graphics; puerto de Remotion → /remotion-to-hyperframes. Fuera del alcance: datos en vivo / en tiempo de renderizado, edición estilo NLE de un video terminado, o producir metraje que HyperFrames no pueda capturar. ¿No está seguro? Lea /hyperframes primero.

Construya exactamente lo que se pidió. Una tarjeta de título es una tarjeta de título — no una tarjeta de título + tres escenas de apoyo + música ambiental + subtítulos. Si escenas o elementos adicionales mejoran genuinamente la pieza, propóngalos; no los agregue silenciosamente. Para ediciones pequeñas (corregir un color, ajustar una duración, agregar un elemento), omita los pasos de planificación y vaya directamente a la construcción.

Enfoque

Descubrimiento — solo para solicitudes abiertas

Para solicitudes vagas y exploratorias ("haz algo para nuestra marca", "una intro genial") — comprenda la intención antes de elegir colores:

  • Audiencia — ¿quién mira? desarrolladores / ejecutivos / consumidores generales?
  • Plataforma — ¿dónde se reproduce? redes sociales (15s) / héroe del sitio web / demo de producto / interno?
  • Prioridad — ¿qué es lo más importante? calidad del movimiento / precisión del contenido / fidelidad de la marca / velocidad?
  • Variaciones — ¿una mejor toma, o 2-3 opciones significativamente diferentes (diferente ritmo, energía o estructura — no solo cambios de color)?

Para solicitudes específicas ("agrega una tarjeta de título", "arregla la temporización en la escena 3"), omita el descubrimiento.

Paso 1 — Sistema de diseño → hyperframes-creative

Establezca la identidad visual primero. Si el proyecto tiene una especificación de diseño, léala (precedencia frame.md → design.md → DESIGN.md; trátela como la verdad de la marca — colores, fuentes, restricciones exactas).

Si no existe especificación, DEBE leer AMBOS hyperframes-creative/references/house-style.md Y hyperframes-creative/references/video-composition.md antes de elegir cualquier color o fuente. house-style.md proporciona la apertura de "interpretar el prompt / generar contenido real", la lista perezosa por defecto y la receta de capas; video-composition.md proporciona las reglas de densidad / escala / detallado de primer plano (barras de datos, marcas de registro, metadatos monoespaciados, "8-10 elementos, dos que el usuario no pidió") que separan lo "producido" de lo "generado". Leer solo uno es el error más común — video-composition.md es el que los agentes omiten, y es exactamente el que evita una salida plana, centrada y con aspecto de página web. No se invente una paleta y omita estos; entrar en hyperframes-creative es obligatorio aquí, no una rama opcional. A partir de ahí, también obtenga un estilo/estado de ánimo con nombre → references/visual-styles.md, o el selector interactivo → references/design-picker.md, según sea necesario. La especificación/estilo define la marca, no las reglas de composición.

Encuentre el ángulo (brief vago, sin especificación): antes de elegir colores, escriba UNA oración — ¿qué evoca este nombre/palabra/tema, y qué mundo visual (metáfora, escenario, instrumento, motivo) lo expresa? P.ej., una herramienta de ciberseguridad → puertas de bóveda / líneas de escaneo de perímetro / pestillos de cerradura; una aplicación de meditación → marea, respiración, floración de luz lenta. Lea el significado del tema, no solo sus letras; elija un ángulo concreto sobre un rediseño literal. Este es el sustituto económico de la expansión del prompt (Paso 2) en piezas de una sola escena, donde la expansión se omite correctamente — y es la diferencia entre un concepto diseñado y un logotipo genérico sobre un degradado.

Paso 2 — Expansión del prompt → hyperframes-creative

Ejecutar para cada composición de múltiples escenas (omitir para piezas de una sola escena y ediciones triviales). Contextualice la solicitud con la especificación de diseño + el estilo de la casa en un intermedio consistente que el trabajo posterior lea de la misma manera. Consulte hyperframes-creative/references/prompt-expansion.md.

Paso 3 — Planificar

Antes de escribir HTML, piense a alto nivel:

  1. Qué — la experiencia del espectador: arco narrativo, momentos clave, ritmos emocionales.
  2. Estructura — cuántas composiciones, sub-comp vs en línea, qué pistas llevan video / audio / superposiciones / subtítulos. Para la decisión de archivo único monolítico vs sub-comp modular, consulte hyperframes-core/references/composition-patterns.md § Dos arquitecturas (regla general: ≥3 cortes de escena duros, o cualquier escena reutilizada → modularizar; una pieza corta de una sola escena permanece en un archivo).
  3. Ritmo — nombre el patrón antes de implementar (p.ej. rápido-rápido-LENTO-SHADER-pausa); consulte hyperframes-creative/references/beat-direction.md.
  4. Temporización — qué clips determinan la duración, dónde caen las transiciones, el ritmo.
  5. Diseño — construya el estado final primero (ver más abajo).
  6. Animar — luego agregue movimiento a través de hyperframes-animation.

Diseño antes de la Animación

Coloque cada elemento donde se encuentra en su momento más visible — completamente entrado, colocado correctamente, sin salir aún. Escríbalo como HTML + CSS estático primero. Aún no hay GSAP.

Por qué: si coloca los elementos en su estado inicial animado (fuera de la pantalla, escalados a 0, opacidad 0) y los interpola hacia donde cree que aterrizan, está adivinando el diseño final — las superposiciones permanecen invisibles hasta el renderizado. Construya el estado final primero y verá y solucionará los problemas de diseño antes de agregar movimiento.

  1. Identifique el fotograma héroe para cada escena — el momento en que la mayoría de los elementos son visibles simultáneamente. Ese es el diseño que construye.
  2. Escriba CSS estático para ese fotograma. El contenedor de contenido debe llenar la escena con relleno, no con desplazamientos absolutos:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* el padding posiciona el contenido; llena cualquier tamaño de escena */
  gap: 24px;
  box-sizing: border-box;
}

Nunca use position: absolute; top: Npx en un contenedor de contenido — se desborda cuando el contenido es más alto que el espacio. Reserve el posicionamiento absoluto para elementos decorativos.

⚠ El width/height: 100% anterior solo se resuelve si cada ancestro tiene una altura resuelta. La raíz <div data-composition-id> y cualquier envoltorio entre ella y .scene-content deben tener tamaño (position: relative; width: 1920px; height: 1080px en la raíz — consulte hyperframes-core → "La raíz debe tener tamaño"). Si omite esto, el contenedor flexible se colapsa a ~0, el contenido se apila en la esquina superior izquierda, y el primer glifo se recorta en x=0 — mientras que lint/inspect aún informan 0 problemas. Y mantenga siempre el padding (≥80px) en .scene-content: es el margen de seguridad del título. Nunca lo reemplace con gap desnudo.

  1. Agregue entradas — anime DESDE fuera de la pantalla/invisible HASTA la posición CSS con gsap.from() (en sub-composiciones prefiera gsap.fromTo() para que el estado inicial sea explícito; consulte hyperframes-core/references/sub-compositions.md). La posición CSS es la verdad fundamental; la interpolación es el viaje hacia ella.
  2. Las salidas son manejadas por transiciones — según las reglas de transición de escena en hyperframes-animation/transitions/, solo la escena final anima los elementos hacia afuera; entre escenas, la transición ES la salida.

Espacio compartido a través del tiempo: si el elemento A sale antes de que el elemento B entre en la misma área, ambos aún necesitan posiciones CSS correctas para sus respectivos fotogramas héroe — el orden de la línea de tiempo evita que coexistan, y el paso de diseño detecta superposiciones accidentales. Los brillos/sombras en capas y la profundidad z-stack son superposiciones intencionales; el paso se trata de detectar colisiones no intencionales (dos titulares uno encima del otro, contenido desbordándose del fotograma).

Construcción — delegue a los skills de dominio

Esto mapea la superficie completa del skill (consulte la description) a sus referencias — no exhaustivo; cuando una intención no esté listada, enrútelos a través de hyperframes-creative (apariencia/concepto), hyperframes-animation (movimiento), hyperframes-core (contrato), hyperframes-media (audio/subtítulos). La primera fila es ADITIVA — léala Y su fila de intención, no una u otra.

Construyendo…Leer primero (en orden)
SIEMPRE — cada pieza no trivial, además de su fila de intención a continuaciónhyperframes-creative/references/house-style.md + references/video-composition.md (también controlado en el Paso 1 / HARD-GATE; el detallado de primer plano "producido, no generado")
Tipografía cinética / centrada en textohyperframes-animation/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Tarjeta de título / tercio inferior / superposición / PiP / texto detrás del sujetohyperframes-creative/references/composition-patterns.md + (para el fotograma centrado/dimensionado) hyperframes-core → "La raíz debe tener tamaño"
Revelación de logotipo / marcahyperframes-animation/rules/svg-path-draw.md (dibujar) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Datos / estadísticas / númeroshyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Demo de producto / aplicación / UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Audio-reactivo / impulsado por músicahyperframes-creative/references/audio-reactive.md (pre-extraer bandas; mapear a movimiento)
Narrado / voz en off / música / SFX / subtítuloshyperframes-media → el motor de audio compartido scripts/audio.mjs (una llamada = TTS + BGM + SFX → audio_meta.json); creación de subtítulos + colocación de activos a través de hyperframes-core. Consulte Audio a continuación.
Multi-escena / transicioneshyperframes-animation/transitions/overview.md luego transitions/catalog.md (no ha terminado después de la descripción general — la receta de GSAP está en el catálogo)
Modular / sub-composicioneshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Audio: un motor (TTS · BGM · SFX)

Solo cuando la pieza lo requiera (según "construya exactamente lo que se pidió" — sin música ambiental en una tarjeta de título). No cree un TTS manualmente ni obtenga una copia de un proveedor: escriba un audio_request.json neutral y llame al motor compartido en hyperframes-media. Se degrada automáticamente en un interruptor: credencial de HeyGen presente → TTS de HeyGen + recuperación de música/SFX; ausente → TTS de ElevenLabs/Kokoro, generación de BGM de Lyria/MusicGen y la biblioteca de SFX incluida. Lista completa de banderas + esquema de solicitud/meta: el comentario del encabezado de hyperframes-media/scripts/audio.mjs.

// audio_request.json — una línea por segmento narrado; `id` es suyo (une audio_meta de vuelta)
{
  "lines": [
    { "id": "s1", "text": "Su línea de apertura.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "El siguiente ritmo." },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // omita "mode" → auto (recuperar si HeyGen, si no generar); "none" para deshabilitar
}
# <MEDIA_DIR> = el directorio del skill hyperframes-media instalado (hermano de este skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Luego lea audio_meta.json: monte cada voices[].path + (bgm.path, sfx[]) como pistas <audio> y use voices[].words para subtítulos, todo según hyperframes-core (pistas de audio + creación de subtítulos). Si BGM tomó la ruta de generación (bgm_pending: true), ejecute hyperframes-media/scripts/wait-bgm.mjs antes del renderizado final.

Lista de verificación de salida → hyperframes-cli

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

lzcjsyr/Book2Video

将 PDF、EPUB、DOCX 等书籍或长文档一次性转成约 4 分钟的中文读书带货短视频口播稿,以情绪共鸣、观看留存和购买欲为核心,直接输出 Book2Video 后续流程可读取的 raw JSON。用户提到读书带货、图书推广、卖书口播、商品卡、走心书单视频、情绪型读书文案或要求生成可直接进入视频流水线的带货稿时使用。

lzcjsyr/Book2Video

将长书、长文档转成中文视频号读书解说稿;先抽取文本并建立可恢复覆盖台账,覆盖自检通过后再按入口定义的正文长度生成初稿、多轮修订和最终 raw JSON。

lzcjsyr/Book2Video

将长书、长文档、PDF、EPUB、读书资料、思想经典、社科著作、商业书或研究型长文转成更有传播感的中文视频号/抖音读书口播稿,并输出项目可用的 raw JSON。只要用户提到“读书解说”“拆书稿”“视频号口播”“把这本书做成短视频”“长文档转视频脚本”“生成标题/封面/金句/raw JSON”,都应使用此 skill。

lzcjsyr/Book2Video

Cody的公众号长文写作skill。当用户需要撰写公众号文章、写稿子、续写文章、根据素材产出长文时使用。触发词包括但不限于:写文章、写稿子、帮我写、续写、扩写、公众号文章、长文、出稿、按我的风格写。即使用户只是说"帮我把这个写成文章"或"用我的风格写一下",只要上下文涉及内容创作和公众号输出,都应该触发。也适用于用户丢过来一个PDF、brief、新闻链接、语音转文字或任何素材说"帮我写篇文章"的场景。不要用于短内容(小红书帖子、推特、朋友圈)或纯标题摘要生成。

lzcjsyr/Book2Video

将中短篇专业报告、公司财报、券商研报、招股书、宏观经济分析及含有较多表格和数据的PDF文档,转化为高品质、数据精准的中文视频号/抖音口播解说稿。只要用户提到“研报”、“财报”、“商业分析报告”或需要“解读数据”、“把报告/PDF做成短视频”,务必使用此 Skill。

lzcjsyr/Book2Video

简化版的文稿生成技能。能够直接读取图书/文档,提取核心论点,生成高品质、口语化的视频号/抖音读书解说文稿并输出标准 JSON 格式。

Skills relacionados