Communitygithub.com

lzcjsyr/Book2Video

Convierte libros y documentos largos (PDF, EPUB, DOCX) en un guion de video corto para promocionar libros en chino, listo para ser procesado por el flujo de trabajo Book2Video.

¿Qué es Book2Video?

Book2Video es una habilidad de agente de IA diseñada para transformar libros o documentos extensos (PDF, EPUB, DOCX) en guiones de video cortos (aproximadamente 4 minutos) para la promoción y venta de libros en plataformas de video corto como Douyin (TikTok chino). Se enfoca en generar un guion altamente persuasivo y emocional que busca maximizar la identificación del espectador, la retención visual y el deseo de compra. La habilidad opera en un solo paso, sin necesidad de subagentes, y produce directamente un archivo `raw.json` con un contrato de 7 campos que puede ser leído por el siguiente paso del flujo de trabajo Book2Video (paso 1.5). El proceso incluye la comprensión del material, la definición de un ángulo de venta emocional, la redacción del guion siguiendo una curva de intensidad emocional, una autoverificación interna y el empaquetado final en el formato JSON requerido. Es útil para creadores de contenido, especialistas en marketing de libros y cualquier persona que necesite generar guiones de video para promocionar libros de manera efectiva y escalable.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lzcjsyr/Book2Video/tree/HEAD/skills/step1/book-commerce-video-script

Preguntar en tu IA favorita

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

Documentación

Video corto para promocionar libros

Una sola ejecución que comprende el material, define el ángulo de venta, redacta el guion, lo auto-revisa y lo empaqueta en raw.json.

El espectador no compra porque "este libro tiene mucho conocimiento". Primero necesita sentir: esta frase me describe a mí, esta confusión por fin alguien la explica con claridad, quizás este libro pueda acompañarme en mi situación actual. Primero conmueve a la persona, luego habla del libro; primero crea la sensación de "lo necesito", luego da la razón de compra.

Restricciones estrictas

  • Una sola ejecución, un solo borrador final, un solo empaquetado final; no diseñar múltiples rondas de revisión.
  • No llamar a subagentes dentro de esta habilidad; tampoco exponer herramientas de agente durante la ejecución.
  • Duración objetivo: aproximadamente 4 minutos; texto principal objetivo: 1050 caracteres chinos, rango aceptable 950-1150, nunca superar 1250.
  • El raw.json final debe cumplir estrictamente el contrato de 7 campos del proyecto, poder ser leído por json.loads y load_step1_agent_raw y entrar directamente al paso 1.5.
  • No inventar contenido del libro original, información de productos, precios, descuentos, existencias, ventas o reseñas de lectores.
  • No redactar como reseña de libro, resumen académico, apuntes de clase o una enumeración fría y objetiva de conocimientos.
  • El texto principal debe tener altibajos emocionales claros, e incluir escenas específicas y relaciones de causa-efecto nítidas que puedan ser representadas visualmente más adelante.

Lectura obligatoria

Leer completa y en orden:

  1. source-and-evidence.md: Extracción, cobertura y límites factuales de libros extensos.
  2. conversion-writing.md: Estructura y estilo de redacción emocional para promoción de libros.
  3. output-contract.md: Archivos de proceso y contrato del JSON final.

Flujo de trabajo único

1. Comprender el material

Siguiendo source-and-evidence.md, extraer el texto completo y establecer un mapa de capítulos y muestras de evidencia acotadas. Fallar solo si el archivo fuente no se puede leer realmente; no escribir basado en la contraportada o resúmenes.

2. Encontrar un ángulo emocional que venda

Formar un commerce brief en el contexto actual, seleccionar solo un ángulo principal:

  • core_audience: el tipo de persona que en este momento tiene más probabilidades de ser conmovida por este libro;
  • life_moment: el instante concreto de su vida que está experimentando;
  • emotional_engine: elegir uno entre relief|recognition|curiosity|awe|hope|ambition|nostalgia|belonging|indignation según la esencia del libro;
  • tension_source: el desajuste específico entre la comprensión actual del espectador y la nueva explicación del libro;
  • unspoken_emotion: un sentimiento o deseo real y no expresado, coherente con el motor emocional principal;
  • piercing_truth: una afirmación que clarifique el desajuste central, pero respaldada por el libro original;
  • emotional_promise: de qué emoción a qué emoción lleva después de escuchar;
  • free_payoff: una historia, idea o giro cognitivo que el video entrega por completo;
  • why_this_book: por qué este libro y no cualquier otro similar;
  • objection: la razón más probable por la que el espectador no compraría, y una respuesta real;
  • cta_boundary: cuando el usuario no haya confirmado explícitamente la tarjeta de producto, usar siempre la búsqueda exacta del título del libro o una acción de compra neutra.

Si el ángulo de venta fuerte es insuficiente, degradar a una recomendación de libro auténtica y mesurada, pero seguir generando un raw.json válido; no inventar heridas, consecuencias graves o valores únicos.

3. Redactar de una sola vez

El texto principal solo genera una versión final; no crear borradores, versiones iterativas o borradores de puntuación. Por defecto, escribir directamente en raw.json; solo en modo depuración guardar adicionalmente _draft_final.txt.

El texto principal avanza según la curva emocional:

  1. 0-8 segundos, dar en el clavo: usar un instante concreto, una afirmación hiriente o una contradicción fuerte para que el espectador objetivo se identifique de inmediato. No presentar primero al autor ni el índice.
  2. 8-45 segundos, aumentar la tensión: explicar claramente el desajuste entre la comprensión actual del espectador y la nueva explicación del libro. La tensión puede venir de la curiosidad, el asombro, el deseo, el coste de oportunidad o un punto débil real; no equivale a crear sufrimiento.
  3. 45-120 segundos, el libro se convierte en la respuesta: mencionar naturalmente el título del libro, y usar una historia, personaje, idea o conflicto del libro para entregar valor real, sin prisas por vender.
  4. 120-200 segundos, completar un giro fuerte: realizar al menos un giro fuerte completo; solo si el libro original proporciona material progresivo, añadir un segundo o tercer giro. Cada giro debe avanzar con el ritmo "detalle del libro original → situación del espectador → derribar la comprensión anterior → cambio que trae la nueva comprensión"; si falta un tiempo, no se considera un giro.
  5. 200-230 segundos, generar deseo de posesión: completar tres puentes de compra: dos valores concretos aún no desarrollados en el libro, un escenario de uso real después de comprarlo, y la respuesta a la objeción central del brief. Los tres deben ser exclusivos de este libro; si funcionan para cualquier otro libro, reescribir.
  6. 230-240 segundos, cierre natural de la venta: dar solo una acción, sin repetir consignas ni inventar descuentos.

4. Autoverificación antes de guardar

Verificar silenciosamente en el contexto actual y seguir corrigiendo hasta que los seis nodos del flujo puedan localizarse con frases concretas en el texto principal. Solo escribir una vez, sin crear archivos de versiones:

  • Los primeros 8 segundos hacen que el espectador objetivo sienta "está hablando de mí", no solo una opinión abstracta;
  • Se puede señalar "detalle del libro original, situación del espectador, comprensión anterior, nueva comprensión y cambio en la persona";
  • Primero se entrega valor real, luego se propone la compra;
  • El conocimiento se traduce en situaciones de la vida, elecciones, relaciones, pérdidas o deseos;
  • Hay una frase hiriente que pueda ser recordada, repetida o compartida;
  • Se explica claramente "por qué este libro";
  • Suena como una persona que realmente recomienda, no como un profesor dando clase;
  • Cumple con los requisitos de longitud, factualidad e información del producto, y tiene escenas suficientemente específicas y relaciones causa-efecto claras para su representación visual posterior;
  • Si al eliminar el título del libro y el contenido propio, el inicio, el giro, la razón de compra o la CTA aún funcionan sin cambios para la mayoría de los libros, se debe reescribir.
  • La última frase debe enlazar con el momento del inicio y el título del libro, haciendo que la acción sea un cierre natural de la emoción.

5. Empaquetar directamente el producto downstream

A partir del texto principal, generar tres conjuntos de títulos de publicación, subtítulos de portada y frases iniciales con gancho, todos coherentes con la promesa, y escribirlos en el raw.json especificado por el usuario, según output-contract.md. Cada conjunto debe estar vinculado a una escena, juicio o giro localizable en el texto principal; la frase inicial debe provenir de una oración original del texto principal o de una versión abreviada que no cambie su significado.

Finalmente, ejecutar:

python <directorio_de_la_habilidad>/scripts/validate_raw.py <ruta_absoluta_del_raw.json>

Al final, solo devolver la ruta del raw.json; no exponer el proceso de análisis al downstream.

Individual skills in this repo

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

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 格式。

lzcjsyr/Book2Video

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

Skills relacionados