Communitygithub.com

Web Video Presentation

Convierte un artículo o guion en una presentación web interactiva de 16:9 que parece un video, con síntesis de voz opcional.

¿Qué es Web Video Presentation?

Este skill transforma artículos o guiones de locución en presentaciones web interactivas, estilo 'video', con una relación de aspecto 16:9. Utiliza un flujo de trabajo colaborativo de múltiples fases: desde la creación del guion y el esquema, pasando por el desarrollo de la página web (capítulo por capítulo, en orden o en paralelo), hasta la síntesis de audio opcional. La presentación se maneja mediante clics para avanzar por el guion, cada paso ocupa la pantalla completa y la barra de progreso solo se muestra al pasar el cursor. Es ideal para contenido educativo, demostraciones de productos o videos para plataformas como YouTube, Bilibili o WeChat Video. Su enfoque principal es la metodología de diseño y la colaboración, no estilos predefinidos, lo que permite reutilizarlo con cualquier tema o estética. El proyecto se basa en Vite + React + TypeScript y es compatible con múltiples proveedores de TTS como MiniMax, OpenAI, ElevenLabs, y edge-tts.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skills/web-video-presentation

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Web Video Presentation?

Convierte un artículo o guion en una presentación web de 16:9 que parece un video, con síntesis de voz opcional. El resultado es un proyecto Vite + React + TS con archivos de audio separados por capítulo.

Escenarios de uso

  • "Tengo un guion de locución o un artículo, conviértelo en un video": contenido impulsado por locución.
  • Crear "PPT dinámico".
  • Grabación de pantalla en 16:9 horizontal, con letras grandes, espacios en blanco y animaciones en cada pantalla.
  • Contenido educativo / demostraciones de productos / keynote con estilo cinematográfico.
  • Contenido para Bilibili / YouTube / TikTok.

Este skill se centra en la metodología y el flujo de trabajo colaborativo. La plantilla base proporciona tokens y primitivas, pero cada decisión estética (paleta de colores, tipografía, estilo de animación) debe rediseñarse para tu tema específico, no copiarse.


Resumen del flujo de trabajo

Fase 1   Redacción de contenido
   1.1  Identificar la entrada del usuario
   1.2  Generar script.md + outline.md (guion de locución + plan de desarrollo)
   ▼
[Checkpoint Plan]  ← Obligatorio. Alinear 5 aspectos:
                     Guion / Esquema / Tema / Materiales / Modo de desarrollo
   ▼
Fase 2   Desarrollo web
   2.1  Scaffolding (según tema seleccionado)
   2.2  Capítulo 1 = Hilo principal + versión completa (ancla obligatoria)
        ▼
        [Nodo duro] Revisión del usuario del Capítulo 1 ← No se puede saltar
        ▼
   2.3  Capítulos 2~N (según modo seleccionado: A Capítulo por capítulo / B Secuencial / C Paralelo)
   ▼
[Checkpoint Audio]  ← Obligatorio. ¿Sintetizar audio?
   ▼
Fase 3   Síntesis de audio (opcional)
   ▼
Fase 4   Grabación de pantalla + Postproducción

Convenciones del directorio de trabajo (el agente crea/edita en el directorio actual del usuario):

my-video/
├── article.md          # Obligatorio si el usuario proporciona el original. ¡No borrar! Fuente de información visual en la fase de desarrollo.
├── script.md           # Obligatorio: Guion de locución adaptado a la plataforma, conservando el idioma original (determina los tiempos).
├── outline.md          # Obligatorio: Plan de desarrollo (división en capítulos + contenido de cada paso + pool de información).
└── presentation/       # Proyecto Vite + React + TS generado por scaffolding.
    ├── src/chapters/<NN>-<id>/
    │   ├── <Chapter>.tsx     # Implementación visual.
    │   ├── <Chapter>.css
    │   └── narrations.ts     # ★ Fuente única de verdad para el número de pasos y el texto de la locución.
    ├── scripts/
    │   ├── extract-narrations.ts   # Escanea todos los narrations.ts → audio-segments.json.
    │   ├── synthesize-audio.sh     # Ejecutor agnóstico al proveedor (itera sobre los segmentos).
    │   └── tts-providers/          # Un archivo .sh por proveedor (2 incluidos).
    │       ├── README.md           # Contrato de 3 funciones + 5 fragmentos de código listos (11labs / edge-tts / say / azure / gcloud).
    │       ├── minimax.sh          # Proveedor por defecto, usa mmx-cli.
    │       └── openai.sh           # OpenAI TTS incluido (curl + OPENAI_API_KEY).
    ├── audio-segments.json         # Salida del extract (revisar antes de sintetizar).
    └── public/audio/<id>/<N>.mp3   # Opcional: archivos de audio sintetizados.

Clave: narrations.ts es la única fuente de verdad para el número de pasos y la síntesis de audio. El número máximo N + 1 que aparece en if (step === N) dentro del .tsx del capítulo debe ser igual a narrations.length. Esto garantiza que 5 lugares (script / outline / código del capítulo / chapters.ts / archivos de audio) nunca divergan.


Protocolo de autoverificación obligatorio (aplica a todo el skill)

Los tres entregables siguientes, después de completarse, deben pasar por autoinspección → reparación → informe/paso siguiente:

EntregableOrigen de la lista de verificación
script.mdSCRIPT-STYLE.md Autoverificación de tres niveles (forma / esencia / lectura en voz alta)
outline.mdOUTLINE-FORMAT.md Autoverificación
Implementación de un capítulo completoCHAPTER-CRAFT.md Autoverificación de finalización

Método de ejecución (en orden descendente de capacidad, priorizar el método más aislado):

  1. Agent Teams (óptimo): Iniciar un agente revisor independiente, proporcionarle "ruta del archivo de salida + lista de verificación correspondiente + contexto clave", para que verifique elemento por elemento e informe estrictamente las conclusiones (qué ítems pasaron / cuáles fallaron + evidencia + sugerencias de reescritura).
  2. subAgent (subóptimo): Si no hay capacidad de Teams pero se puede iniciar un subagente, usarlo con el mismo proceso.
  3. Autoinspección (último recurso): Si el agente actual no tiene ninguna de las capacidades anteriores, debe verificar estrictamente elemento por elemento por sí mismo. No se permite una revisión superficial.

Regla de hierro: Después de obtener las conclusiones, primero corregir los elementos fallidos y luego informar al usuario "completado + conclusiones de la autoverificación + qué se corrigió". Informar directamente las conclusiones sin corregir = infracción.


Guía de lectura de archivos por fase

Diferentes fases leen diferentes archivos. En sesiones largas, el agente tiende a olvidar los principios, especialmente en la Fase 2.4 "Implementar un capítulo" que se repite N veces; cada vez se deben revisar las restricciones principales.

FaseLectura obligatoria (cada vez)Leer una vez / Consultar según sea necesario
Fase 1.1-1.2 Redacción de contenidoreferences/SCRIPT-STYLE.md + references/OUTLINE-FORMAT.md + article.md (texto original del usuario, si existe)——
Checkpoint Plan Seleccionar tema——themes/*/theme.json (leer todos dinámicamente, listar + recomendación bestFor + descriptionZh); references/THEMES.md (cuando el usuario quiera conocer el sistema de temas)
Fase 2.1 Scaffolding——SKILL.md de esta sección leer una vez
Fase 2.4 Implementar capítulo (×N veces, llamado por 2.2 / 2.3)references/CHAPTER-CRAFT.md punto de entrada único – Parte 0 Diez principios / Parte 1 5 preguntas para empezar / Parte 2 Árbol de decisión relación→acción / Parte 3 Caja de herramientas visual / Parte 4 Referencia de duración / Parte 5 Antipatrones anti-AI / Parte 6 Reglas duras de código (incluye restricción obligatoria de narrations.ts) / Parte 7 Autoverificación de finalización / Parte 8 Consulta rápida de comentarios + themes/<id>/theme.json del tema actual + párrafo del outline.md del capítulo actual + article.md párrafo correspondiente a este capítulo + lista de materialesreferences/EXAMPLES/ (referencia estructural, no plantilla para copiar); references/THEMES.md contrato completo de tokens
Fase 3 Síntesis de audioreferences/AUDIO.md (incluye flujo narrations.ts → segments.json → cualquier proveedor, con minimax + openai integrados)templates/scripts/tts-providers/README.md (al cambiar de proveedor / usar TTS propio)
Fase 4 Grabación + Postproducciónreferences/RECORDING.md (incluye ?auto=1 para grabación automática)——
Seleccionar / Crear / Modificar tema——references/THEMES.md

Al escribir un capítulo, solo leer CHAPTER-CRAFT.md. Los diez principios / autopreguntas iniciales / árbol de decisión / antipatrones anti-AI / autoverificación de finalización están todos integrados en este único punto de entrada. EXAMPLES/ no es de lectura obligatoria – primero diseñar libremente según el contenido, consultar solo si hay bloqueo (consultar la "forma" como ancla, no copiar).


Fase 1 – Redacción de contenido (producción única)

1.1 Identificar la entrada del usuario

Lo que da el usuarioQué hacer
Artículo original (lenguaje escrito / WeChat / artículo académico / blog)Generar script.md + outline.md en una sola pasada (1.2), pasar por Checkpoint Plan
Guion de locución / guion de video ya preparadoGuardar como script.md, generar outline.md en una sola pasada (versión simplificada 1.2), pasar por Checkpoint Plan
Sin nada, solo dice "Ayúdame a hacer un video sobre el tema X"Preguntar de vuelta: primero dar un material o esquema. El skill no concibe el contenido por el usuario

1.2 Generar script.md + outline.md en una sola pasada

Los dos productos se completan en una sola reflexión:

  1. Generar script.md: Según las reglas de references/SCRIPT-STYLE.md, convertir el artículo en un guion de locución adaptado a la plataforma, conservando el idioma original. Conservar article.md sin borrar: es la fuente de detalles para el pool de información del outline y la implementación visual de los capítulos (principio de doble fuente).
  2. Generar outline.md: Según las reglas de references/OUTLINE-FORMAT.md, dividir en capítulos + pasos + extraer el pool de información del primer párrafo de cada capítulo.

Límites del outline (clave):

El outline debe incluirEl outline no debe incluir
División en capítulos / Número de pasos por capítulo / Tiempo estimadoTipos de animación específica (blur clear / wipe / spring)
Contenido de la pantalla por paso (hero / datos / eslogan / elementos de lista)Medios de implementación CSS (filter / SVG / clip-path)
Pool de información a nivel de capítulo: números / citas / casos / etiquetas extraídos del artículoValores de duración (no escribir 2.5s / 80120ms)
Prefijo opcional del nombre de la relación a nivel de paso ("Contraste de oposición" / "Lista progresiva" / "Frase clave" etc.)Micro-ritmos como micro-movimiento continuo / compensación escalonada

Razón por la que el outline no escribe animaciones: Si se escriben, el agente del capítulo degenera en una máquina de traducción; el espacio en blanco permite que el agente del capítulo diseñe libremente siguiendo el "árbol de decisión impulsado por el contenido" de CHAPTER-CRAFT.md al comenzar cada paso, logrando así una verdadera sensación de video. Ver CHAPTER-CRAFT.md Parte 0 Principio 7.

Después de guardar, primero pasar por autoverificación antes de entrar a Checkpoint Plan: Según el «Protocolo de autoverificación obligatorio» anterior, ejecutar sobre script.md / outline.md respectivamente (priorizar Agent Teams → subAgent → autoinspección), reparar según las conclusiones y luego entrar a Checkpoint Plan.


Checkpoint Plan – Alinear 5 aspectos a la vez (Nodo duro)

Después de escribir script.md + outline.md, hay que detenerse. El usuario confirma simultáneamente 5 aspectos en este nodo.

Trabajo preparatorio que el agente debe hacer en este momento

  1. Leer todos los themes/*/theme.json para obtener nameZh / descriptionZh / bestFor / mood – No codificar la lista.
  2. Según el tipo de contenido / palabras clave / tono de script.md, seleccionar activamente 2~3 juegos de recomendaciones más adecuadas de los temas (coincidiendo con el campo bestFor).
  3. Revisar la sección "Lista de materiales" al final de outline.md.

Plantilla de resumen (esqueleto, el agente rellena según el caso)

Plan de contenido completado, archivos generados:
  📄 article.md     {Si el usuario proporcionó el original, se conserva}
  📄 script.md      {X} palabras / ~{T} minutos
  📄 outline.md     {N} capítulos / {M} pasos + pool de información por capítulo + lista de materiales al final

Resumen de capítulos:
  1. <id>     <Título del capítulo>    <S> pasos ~<T>s
  2. ...

A continuación, alinear 5 aspectos a la vez:

  1. ¿El guion (script.md) necesita cambios?
     Puedes editar el archivo directamente o indicarme la dirección de los cambios oralmente.

  2. ¿El plan de desarrollo (outline.md) necesita cambios? Presta especial atención a:
     - ¿Es razonable la división en capítulos / número de pasos / tiempo estimado? (Razonable: 30~60s por capítulo)
     - ¿Es claro el contenido de la pantalla por paso?
     - ¿El «pool de información» del primer párrafo de cada capítulo tiene suficientes detalles del artículo para enganchar la imagen?
     - ¿Está completa la lista de materiales al final?

  3. ¿Qué tema elegir? Mis recomendaciones:
     ★ <Recomendación 1: nameZh (id)> — Porque <coincidencia bestFor>; <resumen descriptionZh>
     ★ <Recomendación 2 / Recomendación 3>
     Otras opciones: <Temas restantes, nameZh + una frase>
     También puedes pedirme que cree un tema nuevo (ver references/THEMES.md).

  4. ¿Cómo preparar los materiales reales? Un vistazo rápido a las imágenes necesarias para este video: <Lista aproximada>
     a) Yo selecciono de <Ruta de materiales existentes>   b) Tú los proporcionas   c) Todo placeholder

  5. ¿Qué modo de desarrollo eliges?

     **El Capítulo 1 debe completarse en el hilo principal con revisión del usuario sin importar el modo** (ancla obligatoria).
     La diferencia está a partir del Capítulo 2:

     A) Por defecto · Confirmación capítulo por capítulo (recomendado)
        Pausa y revisión al terminar cada capítulo → Riesgo controlable / Ritmo más estable
     B) Desarrollo secuencial después del Capítulo 1 (sin paralelismo)
        Los capítulos 2~N se completan secuencialmente en el hilo principal y se revisan al final → Velocidad media / Adecuado para agentes que no soportan tareas paralelas
     C) Desarrollo en paralelo después del Capítulo 1 (subagentes)
        Los capítulos 2~N se completan en paralelo con subagentes → Más rápido / El usuario controla el número de tareas paralelas (¿cuántos capítulos a la vez?)
        ⚠️ Habrá diferencias de estilo entre capítulos (esto es esperado, los tokens del tema evitan que se salga de control)

Después de recibir comentarios:

  • Si hay que cambiar el guion / outline: editar el archivo directamente, y después de editar, ping (o el agente cambia según la descripción oral).
  • El tema debe estar claro para entrar a Fase 2. Si el usuario dice "tú eliges el tema" → tomar la primera recomendación, decirle al usuario qué se eligió y por qué, darle oportunidad de cambiar de opinión.
  • Modo seleccionado → Entrar a Fase 2.

Fase 2 – Desarrollo web

2.1 Scaffolding

bash <ruta-a-web-video-presentation>/scripts/scaffold.sh \
  ./presentation \
  --theme=<id del tema seleccionado por el usuario>

bash <ruta-a-web-video-presentation>/scripts/scaffold.sh --list-themes

Tema personalizado → Primero, según el flujo de "Crear nuevo tema" de references/THEMES.md, crear un themes/<my-theme>/, luego --theme=<my-theme>.

El scaffolding incluye un demo 01-example. Eliminarlo antes de escribir el contenido real del primer capítulo:

rm -rf presentation/src/chapters/01-example

Y eliminar el import y el elemento del array EXAMPLE_CHAPTER en presentation/src/registry/chapters.ts.

2.2 Capítulo 1 – Hilo principal + Revisión obligatoria

Clave: El Capítulo 1 es la versión completa de una sola vez (ritmo + imagen + materiales reales completos). No existe el concepto de "versión esqueleto" – el primer capítulo debe ser un prototipo que el usuario pueda revisar directamente.

Por qué el Capítulo 1 debe estar en el hilo principal:

  • Es la primera aplicación de la guía CHAPTER-CRAFT.md en el tema actual + contenido actual.
  • Si la guía tiene puntos ciegos / los tokens de color o fuente del tema son insuficientes, el Capítulo 1 lo revelará – entonces, con la retroalimentación humana, se puede ajustar la guía o el tema, el costo de corregir temprano es mínimo.
  • Los capítulos siguientes (sean secuenciales o paralelos) deben tomar como referencia el patrón de código del Capítulo 1. Por lo tanto, el Capítulo 1 es el "ancla de estilo" del proyecto actual (no se busca uniformidad entre capítulos, pero el capítulo en sí mismo debe tener una capacidad de persuasión completa).

Después de completar el Capítulo 1, hay que detenerse y esperar la revisión del usuario:

Capítulo 1 <id> completado. El servidor de desarrollo se ejecuta en localhost:5173.

Puntos clave de revisión:
  □ ¿La atmósfera visual es la correcta? ¿Coincide con las expectativas de <nombre del tema>?
  □ ¿El ritmo es correcto? ¿Algún paso demasiado rápido / demasiado lento / información demasiado escasa?
  □ ¿Las animaciones están impulsadas por el contenido? ¿O hay pasos con animaciones de entrada sin sentido?
  □ Principio de doble fuente: ¿La pantalla tiene detalles que "la locución no menciona pero el artículo sí"?
  □ Verificación anti-AI: ¿Hay degradados púrpura-rosa / bordes redondeados de colores / ilustraciones falsas / emojis?

Dime los problemas y los corregiré. Cuando esté bien, dime "continuar" y haré el Capítulo 2 y siguientes según el modo seleccionado.

2.3 Capítulos 2~N – Según modo seleccionado

Regla común en todos los modos: Cada capítulo se desarrolla de forma independiente según CHAPTER-CRAFT.md. No se busca uniformidad total de estilo entre capítulos – los tokens de color / fuente del tema garantizan la uniformidad visual; las animaciones / ritmo / demostración visual quedan a la libre interpretación del capítulo, lo cual es un objetivo de diseño.

Modo A · Por defecto · Confirmación capítulo por capítulo

Capítulo 2 completado → Pausa para revisión → OK → Capítulo 3 → Pausa → ... → Capítulo N. Revisión independiente de cada capítulo, problemas corregibles en cualquier momento, menor riesgo, ritmo más estable. Si el usuario no selecciona un modo explícitamente, se usa este por defecto.

Modo B · Desarrollo secuencial después del Capítulo 1

Capítulo 2 → Capítulo 3 → ... → Capítulo N completados secuencialmente en el hilo principal, revisión final unificada. Velocidad media, adecuado para entornos donde el agente no soporta tareas paralelas.

Modo C · Desarrollo en paralelo después del Capítulo 1 (subagentes)

Usar subagentes para completar los capítulos 2~N en paralelo. El número máximo de tareas paralelas lo controla el usuario ("4 capítulos a la vez" / "2 capítulos a la vez"). Más rápido, pero habrá diferencias de estilo entre capítulos – esto es esperado, porque:

  1. Cada subagente no ve el resultado de los otros subagentes, por lo que no pueden alinearse mecánicamente.
  2. El código de los capítulos está físicamente separado (una carpeta por capítulo / prefijo CSS propio), sin interferencias mutuas.
  3. Los tokens del tema garantizan la uniformidad visual (colores / fuentes / números hero / tarjetas / líneas divisorias / decoraciones), la atmósfera no se desvía.
  4. La falta de uniformidad de estilo = la sensación de respiración de un video escrito a mano (múltiples voces / múltiples perspectivas).

El prompt del subagente paralelo debe incluir:

  • El párrafo del outline del capítulo actual (con el pool de información).
  • La ruta de references/CHAPTER-CRAFT.md (lectura única obligatoria – requisitos de demostración visual + revelación progresiva + principio de doble fuente + anti-AI + líneas rojas de código + autoverificación de finalización, todo en este archivo).
  • descriptionZh / mood / bestFor del theme.json del tema actual (consultar la atmósfera, pero las animaciones / duración / tamaño de fuente / emojis los decide libremente el agente del capítulo).
  • El código del Capítulo 1 como referencia de "estilo de código" (no como "objeto de copia visual").
  • Regla dura: prefijo CSS independiente por capítulo (.cd- / .mg- / .pm- / ...); no modificar chapters.ts; al finalizar, ejecutar npx tsc --noEmit.

Importante: Independientemente del modo seleccionado, el usuario puede cambiar de modo en cualquier momento. Si el Capítulo 2 está bien, el usuario puede decir "el resto en paralelo" / "el resto capítulo por capítulo".

2.4 Implementar un capítulo (obligatorio para cada capítulo)

Ver la guía detallada en references/CHAPTER-CRAFT.md – punto de entrada de lectura única obligatoria, que cubre: requisitos de demostración visual / revelación progresiva / selección de contenido / principio de doble fuente / estética básica de la demostración en video / anti-AI / líneas rojas de código / autoverificación de finalización.

Puntos clave (detallados en CHAPTER-CRAFT.md):

  • Cada capítulo debe tener una demostración visual con CSS / SVG / Canvas / JS, prohibidos los capítulos de solo texto.
  • Revelación progresiva: Las listas / enumeraciones deben mostrar 1 elemento = 1 paso, prohibido mostrar todo de una vez.
  • Principio de doble fuente: El ritmo sigue al guion de locución (el orden no puede alterarse), los detalles se extraen del artículo original (pool de información + párrafo del artículo de este capítulo).
  • Pasar por la autoverificación de finalización elemento por elemento, si no se cumple, volver a corregir – según el «Protocolo de autoverificación obligatorio» anterior (priorizar Agent Teams → subAgent → autoinspección), corregir antes de informar al usuario la entrega del capítulo.

2.5 Aumentar STORAGE_KEY después de cambios grandes

Después de modificar chapters.ts (añadir / eliminar / reordenar capítulos, o cambios en la longitud de narrations.ts de algún capítulo), aumentar STORAGE_KEY en presentation/src/hooks/useStepper.ts (ej. v4 → v5), para evitar que el cursor persistente caiga en un paso inexistente.


Checkpoint Audio – ¿Sintetizar audio? (Nodo duro)

Al finalizar la Fase 2, hay que detenerse y preguntar al usuario:

Página web completada, {N} capítulos {M} pasos, servidor de desarrollo en localhost:5173.

¿Sintetizar audio para grabación de pantalla con reproducción automática?
  ✓ Sintetizar → Escanear todos los narrations.ts de los capítulos para generar audio-segments.json,
                 llamar al proveedor TTS para sintetizar un mp3 por paso en public/audio/.
                 Después de la síntesis, se puede usar el modo ?auto=1 para grabar la pantalla en una sola toma (audio y video sincronizados naturalmente).
                 Dos proveedores incluidos:
                   • minimax (mmx-cli)    – Por defecto, estable para voz en chino.
                   • openai  (OPENAI_API_KEY) – Basado en curl, la mayoría ya tiene clave.
                 Otros backends (ElevenLabs / edge-tts gratuito / macOS say offline /
                 Azure / Google) ver los fragmentos listos en scripts/tts-providers/README.md.
  ✗ No sintetizar → Saltar Fase 3, ir directamente a Fase 4 con grabación manual + locución en postproducción.

Si quiere sintetizar → Fase 3. Si no → directamente Fase 4.


Fase 3 – Síntesis de audio (opcional)

Ver el flujo detallado en references/AUDIO.md. Versión simplificada:

cd presentation
npm run extract-narrations   # Escanea todos los narrations.ts → audio-segments.json
# Deja que el usuario eche un vistazo a audio-segments.json para confirmar el texto.
npm run synthesize-audio                       # Proveedor minimax por defecto, incremental
# O usar el openai incluido (necesita OPENAI_API_KEY):
PRESENTATION_TTS=openai npm run synthesize-audio
# O personalizado: escribir un scripts/tts-providers/<nombre>.sh, ver el README.md de ese directorio.

Después de la síntesis, informar al usuario: ubicación de salida / número total de segmentos / qué segmentos tienen duraciones anómalas (demasiado largos = el paso necesita dividirse; demasiado cortos = el texto es muy escaso) – dar la última oportunidad de calibrar el ritmo. Luego entrar a Fase 4.


Fase 4 – Grabación de pantalla + Postproducción

Ver references/RECORDING.md para más detalles. Dos caminos:

EscenarioCamino recomendado
Fase 3 con audio sintetizadoModo Auto de una sola toma: Abrir localhost:5173/?auto=1 en el navegador → Presionar SPACE → El video completo se reproduce automáticamente → Detener la grabación → Recortar el inicio y final → Video terminado, sin necesidad de sincronizar pistas de audio en postproducción
Fase 3 omitidaModo Manual por defecto, avanzar haciendo clic manualmente → Sincronizar audio con cualquier herramienta de edición en postproducción

El agente, después de la Fase 3 / Checkpoint Audio, debe informar activamente al usuario sobre la ruta de grabación adecuada.


Diez principios (lista de una frase)

El desarrollo completo está en references/CHAPTER-CRAFT.md Parte 0 – Al escribir un capítulo, consultar allí. Lo siguiente es solo un índice.

#PrincipioUna frase
1Escenario fijo 16:9Contenido 1920×1080 + transform scale, sin responsividad
2Contador de pasos globalEl capítulo es una función pura de los pasos, sin temporizadores
3Cada paso ocupa toda la pantallaif (step === N) return <FullScene />
4Tiempo de locución = pasoUn tiempo = un paso = una idea enfocada
5Controles de esquina ocultosBarra de progreso / navegador con opacidad 0 por defecto
6Escenario sin cromoSin header / footer / número de página / barra de marca
7Animaciones impulsadas por el contenidoPrimero buscar la acción intrínseca, solo si no se encuentra usar animación de entrada; micro-movimiento continuo con moderación
8Revelación múltiple punto por punto1 elemento = 1 paso, prohibido mostrar N elementos a la vez con stagger
9Mismo tema en todo el videoNo cambiar el color de fondo entre capítulos; colores / fuentes mediante tokens, otras escalas libres por capítulo
10Principio de doble fuenteEl script marca el ritmo, el artículo determina la densidad visual (materializada en el pool de información)

Consulta rápida de comentarios comunes del usuario

Tabla simplificada en references/CHAPTER-CRAFT.md Parte 8 «Consulta rápida de comentarios comunes». Clave: Primero identificar a qué nivel pertenece (ritmo / visual / contenido / código), luego modificar la porción más pequeña, no rehacer todo el capítulo.


Recursos relacionados

Marcados con "cuándo leer" para evitar leer todo de una vez:

ArchivoCuándo leerContenido
references/SCRIPT-STYLE.mdFase 1.2 Lectura obligatoriaReglas para convertir artículo → guion de locución, variantes de plataforma
references/OUTLINE-FORMAT.mdFase 1.2 Lectura obligatoriaEspecificación de campos de outline.md, convenciones de nomenclatura, división de capítulos, pool de información
references/CHAPTER-CRAFT.mdFase 2.4 Punto de entrada único de lectura obligatoria para cada capítuloParte 0 Diez principios / Parte 1 5 preguntas para empezar / Parte 2 Árbol de decisión relación→acción / Parte 3 Caja de herramientas visual / Parte 4 Duración / Parte 5 Antipatrones anti-AI / Parte 6 Reglas duras de código / Parte 7 Autoverificación de finalización / Parte 8 Consulta rápida de comentarios
references/EXAMPLES/Opcional – ver estructuraEjemplos de estructura de capítulos (hook / list-reveal / case-tech-review); no son plantillas para copiar
references/THEMES.mdAl seleccionar / crear / modificar temasContrato completo de tokens + lista de temas integrados + flujo de creación
references/AUDIO.mdSolo leer en Fase 3Flujo de síntesis de audio agnóstico al proveedor, uso de minimax integrado, ruta para cambiar de proveedor, solución de problemas
templates/scripts/tts-providers/README.mdAl cambiar / añadir proveedor TTSContrato de 3 funciones + 2 integrados (minimax / openai) + 5 fragmentos de código listos (ElevenLabs / edge-tts / macOS say / Azure / Google)
references/RECORDING.mdSolo leer en Fase 4Herramientas de grabación de pantalla + postproducción
themes/Consultar en Checkpoint Plan / Fase 1.2Temas integrados (cada uno con theme.json + tokens.css)
scripts/scaffold.shEjecutar una vez en Fase 2.1Scaffolding del proyecto con un solo comando

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados