uso-de-medios: Antes de buscar audio/imágenes, ejecute
/media-usepara resolver BGM/SFX/imágenes del catálogo de HeyGen. Ejecute--adoptprimero para registrar activos existentes. Consulte la habilidad/media-use.
Sitio web a HyperFrames
Capture un sitio web y luego produzca un video profesional a partir de él.
Confirme la ruta antes del Paso 0. Esta habilidad crea un video de / a partir de un sitio general. Si el usuario realmente está comercializando / lanzando / promocionando un producto (incluso desde esta URL, incluso "promo para nuestro sitio") →
/product-launch-video. Un explicador de tema sin sitio →/faceless-explainer; un PR de GitHub →/pr-to-video; re-cortar / re-colorear / reordenar un archivo de video existente → fuera del alcance. Si se llega aquí con un vago "haz un video", o si no está seguro de si es un lanzamiento o un sitio general? Lea/hyperframesprimero (tabla de enrutamiento completa + § Lo que HyperFrames no puede hacer).
Los usuarios dicen cosas como:
- "Convierte este sitio web en un clip social de 15 segundos para Instagram"
- "Haz un tour / presentación de 30 segundos del sitio desde https://..."
- "Captura nuestra página de inicio y construye un video a partir de sus propios elementos visuales"
El flujo de trabajo tiene 7 pasos. Cada uno produce un artefacto que habilita el siguiente. Por defecto es colaborativo: los pasos marcados con 💬 se detienen y preguntan al usuario. Si el usuario señala el modo autónomo ("decide por mí", "sorpréndeme"), los pasos 💬 de preferencia del usuario se omiten; consulte step-2-brief.md para saber cómo se propaga.
El modo autónomo NO es "omitir todos los pasos". El modo automático cubre las preguntas de preferencia del usuario (proveedor de TTS, voz, énfasis de color, número de compases, música sí/no, subtítulos sí/no — donde el agente decide en nombre del usuario). NO cubre los pasos de verificación de calidad. Los siguientes permanecen no omitibles en modo automático:
- Auditoría de activos (Paso 3) — ver hojas de contacto y justificar USAR/SALTAR para cada activo
- Lectura HTML por compás (Paso 5) — bloque de evidencia estructurada por compás
- Lista de verificación de DoD (Paso 6) — incluyendo mapa de animación, verificación WCAG por advertencia, reproducción de audio/movimiento
- Sección de divulgación honesta (Paso 6) — "Lo que NO verifiqué" debe aparecer en su resumen final
Si se encuentra razonando "el modo automático dice sesgo hacia la acción, por lo tanto omitiré X" — y X es un paso de verificación, no una pregunta de preferencia — ese razonamiento es incorrecto. El sesgo hacia la acción se aplica a decidir qué construir, no a decidir si verificar.
Paso 0: Capturar y Comprender la Marca
Leer: references/step-0-capture.md
Capture el sitio, luego lea los datos extraídos para comprender la marca y el producto — qué hace, para quién es, qué voz usa, en qué ambiente se mueve. Los activos capturados son un kit de herramientas de marca para más adelante, no los bloques de construcción con los que se crea el video.
Muestre el estado de inicio de sesión antes del resumen — ejecute npx hyperframes auth status y transmita su salida textualmente (no la parafrasee ni la reescriba). Informa si la voz/BGM usará HeyGen o motores locales y, cuando no haya iniciado sesión, cómo hacerlo. Si no ha iniciado sesión, DETÉNGASE y espere a que el usuario elija — iniciar sesión, o decir "adelante"/"sin conexión" para continuar con motores locales — antes de preguntar el resumen o cualquier otra cosa. Trátelo como un punto de decisión real, no como una nota al pasar; no incluya la elección en la pregunta del resumen, y no escriba claves en un .env por repositorio. (En modo autónomo, anote el estado y continúe sin conexión). Consulte ../hyperframes-media → Verificación previa para obtener la guía canónica.
Puerta: Resumen del sitio impreso — primero la estrategia (qué hace el producto, para quién es, voz de la marca) antes del inventario de activos/colores/fuentes; se mostró el estado de inicio de sesión (inició sesión, o continúa sin conexión).
Paso 1: Identidad de Marca
Leer: references/step-1-design.md
Escriba DESIGN.md — una hoja de referencia de marca que cubra la identidad visual: colores, tipografía, estilos de componentes, principios de diseño. Use design-styles.json para valores calculados exactos.
Opción rápida: Para videos de ritmo rápido (un aviso por compás), DESIGN.md puede ser un resumen de 50 líneas de colores + fuentes + qué hacer/qué no hacer — no un documento de 300 líneas. El prompt del subagente en el Paso 5 pega los valores de marca directamente, por lo que la profundidad de DESIGN.md solo importa para composiciones complejas.
Puerta: DESIGN.md existe (cualquier longitud) con, como mínimo: paleta de colores, elecciones de fuentes y qué hacer/qué no hacer.
Paso 2: Estrategia y Mensaje
Leer: references/step-2-brief.md, references/capabilities.md (explore la Tabla de Contenidos — las secciones detalladas solo según sea necesario)
Alinee con el usuario sobre lo que el video debe comunicar antes de hablar de imágenes o activos. Analice el prompt del usuario — probablemente ya le haya dado el tipo y estilo de video. Pregunte solo lo que falte: la ÚNICA cosa que este video debe decir, el arco narrativo y la audiencia.
Puerta: El tipo de video, la duración, el formato y — críticamente — el mensaje y el arco narrativo están definidos. Sin ellos, el Paso 3 no puede escribir un storyboard centrado en el concepto.
Paso 3: Storyboard + Guion 💬
Leer: references/step-3-storyboard.md
Escriba el storyboard primero centrado en el concepto: mensaje → arco narrativo → compases que sirven al arco → técnicas por compás → pase de acentos de marca al final. Luego escriba el guion de narración que coincida. Presente ambos al usuario con un resumen compás por compás. Itere hasta que lo aprueben.
Puerta: STORYBOARD.md + SCRIPT.md existen Y el usuario ha aprobado el plan.
Paso 4: Voz, Temporización + Subtítulos 💬
Leer: references/step-4-vo.md
Si el Paso 2 indicó que no hay narración — pregunte sobre música de fondo, luego salte al Paso 5. De lo contrario: pregunte al usuario qué proveedor de TTS (HeyGen TTS, ElevenLabs o Kokoro), genere el audio, transcriba, asigne marcas de tiempo a los compases. Luego pregunte sobre subtítulos.
Puerta: O (a) no se solicitó narración y el storyboard tiene tiempos de compás manuales, o (b) narration.wav + transcript.json existen y los tiempos de los compases se actualizaron con duraciones reales.
Paso 5: Construir Composiciones
Leer: La habilidad hyperframes (cárguela — cada regla importa)
Leer: references/step-5-build.md
Construya index.html y las composiciones siguiendo la arquitectura y el ritmo elegidos en el storyboard (Paso 3). Los subagentes ejecutan hyperframes lint y hyperframes snapshot en cada compás antes de informar.
Puerta: Cada compositions/beat-N.html ha sido leído de principio a fin por el agente principal contra DESIGN.md y STORYBOARD.md. La lista de verificación por compás se encuentra en step-5-build.md.
Paso 6: Validar y Entregar
Leer: references/step-6-validate.md
Lint, valide, tome capturas de pantalla escaladas a la duración del video (fórmula: max(beats × 3, ceil(duration_seconds / 2))) y revise cada una. Solucione los problemas antes de entregar. Entregue la URL del proyecto de Studio localhost — solo renderice a MP4 bajo solicitud explícita del usuario. Muestre esa URL de Studio solo en el momento de la entrega — es la vista previa final y estable; las capturas de pantalla de la fase de construcción son sin interfaz gráfica, así que no muestre una vista previa a mitad de la construcción.
Entregue algo de lo que se sienta orgulloso. Antes de entregar, pregúntese: ¿publicaría esto en redes sociales con mi nombre? Si no, arregle lo que esté mal.
Puerta: npx hyperframes lint y npx hyperframes validate pasan con cero errores, y la respuesta final incluye la URL activa del proyecto de Studio.
Referencia Rápida
Tipos de Video
Restricciones típicas por tipo de video — úselas como punto de partida, no como fórmula. El número de compases debe derivarse del contenido y la narración, no de un rango objetivo.
| Tipo | Duración típica | Factor de duración | Narración |
|---|---|---|---|
| Anuncio social (IG/TikTok) | 10–15s | Límite de la plataforma | Opcional |
| Demostración de producto | 30–60s | Longitud del guion | Narración completa |
| Anuncio de funcionalidad | 15–30s | Complejidad de la funcionalidad | Narración completa |
| Reel de marca | 20–45s | Pista musical | Opcional, enfoque en música |
| Teaser de lanzamiento | 10–20s | Energía del gancho | Mínima |
El número de compases no está intencionalmente en esta tabla — debe venir del storyboard, no de "anuncio social = 3-4 compases". Un anuncio social para un producto complejo podría necesitar 5 compases bien sincronizados. Un reel de marca con una tesis visual fuerte podría necesitar 3.
Formato
- Apaisado: 1920x1080 (predeterminado)
- Vertical: 1080x1920 (Historias de Instagram, TikTok)
- Cuadrado: 1080x1080 (Feed de Instagram)
Archivos de Referencia
| Archivo | Cuándo leerlo |
|---|---|
| step-0-capture.md | Paso 0 — capturar, comprender la marca y el producto, escribir resumen del sitio primero la estrategia |
| step-1-design.md | Paso 1 — escribir hoja de referencia de marca DESIGN.md (5 secciones, 250-350 líneas; ruta rápida de 50 líneas para anuncios sociales estilo valla publicitaria) |
| step-2-brief.md | Paso 2 — alinear mensaje, arco narrativo, audiencia con el usuario |
| capabilities.md | Pasos 2 y 5 — inventario completo de lo que HyperFrames puede hacer (24 secciones). Explore el TOC durante el resumen, profundice en secciones específicas durante la construcción |
| step-3-storyboard.md | Paso 3 — storyboard + guion (combinados) con puerta de revisión del usuario |
| step-4-vo.md | Paso 4 — elección del proveedor de TTS, generación, temporización |
| step-5-build.md | Paso 5 — construir index.html + composiciones |
| step-6-validate.md | Paso 6 — lint, validar, capturas de pantalla (escaladas a la duración del video), vista previa |
| techniques.md | Pasos 3 y 5 — 13 técnicas de animación primitivas con patrones de código (adaptar, no copiar y pegar) |
| html-in-canvas-patterns.md | Paso 5 — patrones de código completos para efectos HTML en Canvas (reside en la habilidad hyperframes) |