media-use: Antes de obtener audio/imágenes, llama a
/media-usepara resolver BGM/SFX/imágenes del catálogo de HeyGen. Ejecuta--adoptprimero para registrar los activos existentes. Consulta la skill/media-use.
Lanzamiento de Producto a HyperFrames
Usa esta skill para capturar un producto, comprender su marca, planificar un video de lanzamiento y construirlo cuadro por cuadro en HyperFrames.
Confirma la ruta antes del Paso 0. Eres el orquestador. Ejecuta cada paso, verifica su compuerta, y solo entonces continúa al siguiente paso. Esta skill es para un producto que se está comercializando, lanzando, promocionando o revelando, incluyendo solicitudes como "promo para nuestro sitio" cuando el propósito es promocional. Enruta otras intenciones a otra parte: un recorrido general de sitio web no relacionado con lanzamientos ->
/website-to-video; un explicador de tema sin producto ->/faceless-explainer; una solicitud de extracción de GitHub ->/pr-to-video; subtítulos en material existente ->/embedded-captions; un gráfico en movimiento corto sin narración ->/motion-graphics. Si el usuario solo dice "haz un video" o la ruta es incierta, lee/hyperframesprimero.
Eres el orquestador. Trabaja en videos/<proyecto>/. Ejecuta los pasos en orden y pasa cada compuerta antes de continuar. Los pasos con compuerta de usuario son el Paso 0, el Paso 3 y el Paso 6. Haz cada paso tú mismo excepto el Paso 5, donde despachas un sub-agente por fotograma. No pongas reglas de diseño o movimiento aquí; esas viven en el sub-agente trabajador de fotogramas, en ../hyperframes-animation/rules/ local de esta skill + ../hyperframes-animation/blueprints/, y en hyperframes-creative.
Flujo de trabajo: Paso 0 configuración -> hyperframes.json; Paso 1 captura -> capture/; Paso 2 sistema de diseño -> frame.md; Paso 3 guion gráfico/script -> STORYBOARD.md y SCRIPT.md; Paso 3.1 audio -> audio_meta.json; Paso 4 diseño visual -> STORYBOARD.md enriquecido; Paso 5 fotogramas -> compositions/frames/NN-*.html y index.html; Paso 6 renderizado final -> renders/video.mp4.
Paso 0: Configuración y Resumen
Objetivo: Bloquear el resumen central del video y crear el proyecto HyperFrames si es necesario.
Inicializa solo si falta hyperframes.json. Nombra <proyecto> a partir de la marca o dominio en kebab-case, como acme-promo; nunca uses el nombre del espacio de trabajo o la marca de tiempo.
npx hyperframes init "videos/<proyecto>" --non-interactive --example=blank — init verifica las skills instaladas contra las más recientes en GitHub y actualiza el conjunto global si alguna está desactualizada.
Muestra el estado de inicio de sesión antes del resumen — ejecuta npx hyperframes auth status y transmite su salida textualmente (no la parafrasees ni la reescribas). Informa si la voz/BGM usará HeyGen o motores locales y, cuando no se ha iniciado sesión, cómo hacerlo. Si no se ha iniciado sesión, DETENTE y espera a que el usuario elija: iniciar sesión, o decir "go"/"offline" para continuar con motores locales — antes de preguntar el resumen o cualquier otra cosa. Trátalo como un punto de decisión real, no como una nota pasajera; no combines la elección en la pregunta del resumen, y no escribas claves en un .env por repositorio. (En modo autónomo, anota el estado y continúa sin conexión). Consulta ../hyperframes-media → Preflight para la guía canónica.
Compuerta: hyperframes.json existe, y el ángulo, la duración, la relación de aspecto y el idioma están bloqueados; se mostró el estado de inicio de sesión (iniciado sesión, o continuando sin conexión).
Paso 1: Capturar activos
Objetivo: Recopilar el material fuente, las señales de marca y los activos utilizables para el video.
Clasifica la entrada y elige la ruta. URL explícita -> captúrala y usa el sitio para la narración y los activos. Script/resumen pegado -> guárdalo textualmente como user_script.txt, pregunta una vez "¿usarlo textualmente o reestructurarlo?", almacena la respuesta como VO_MODE, luego resuelve el objetivo de captura: URL en el texto -> úsala; solo nombre de marca -> WebSearch, confirma la URL en una línea, luego rastrea; sin URL/sitio -> ruta sin captura.
Ejecuta la captura con: npx hyperframes capture "<URL>" -o ./capture
Si existe GEMINI_API_KEY, GOOGLE_API_KEY o una clave de OpenRouter, la captura agrega automáticamente subtítulos a los activos en capture/extracted/asset-descriptions.md. Esta no es una compuerta de revisión. Sin una clave de visión, usa el contexto DOM y continúa.
Ruta sin captura: crea capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md y capture/assets/ manualmente. tokens.json debe ser { "title": "", "description": "", "colors": [], "fonts": [] }; completa título/descripción a partir del resumen cuando sea posible. visible-text.txt contiene el resumen o script completo. asset-descriptions.md debe decir que no se capturaron activos a menos que el usuario haya dado notas de activos.
Compuerta: capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md y capture/assets/ existen; puedes indicar la marca en una oración clara. Trata asset-descriptions.md como el inventario principal de activos. Si falta después de la captura real, detente e informa que la captura está incompleta. Si existe capture/BLOCKED.md, síguelo.
Paso 2: Sistema de Diseño
Objetivo: Elegir un preset de fotograma enviado; un script lo convierte en el frame.md + máscara de subtítulos de este video.
Tú haces la única llamada de juicio — qué preset. Lee ../hyperframes-creative/references/design-spec.md y elige el preset cuyo aspecto se ajuste mejor a la marca y al resumen. Luego ejecuta:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <nombre> --hyperframes .
El script hace el resto de forma determinista: copia el FRAME.md del preset → frame.md y lo remezcla sobre los tokens de marca en capture/extracted/tokens.json (los colores de la marca mapeados a las claves de color del preset por rol — tinta, lienzo, acentos — manteniendo claves/estructura/componentes; las fuentes de visualización + cuerpo del preset se intercambian por las de la marca), copia la máscara de subtítulos del preset a .hyperframes/caption-skin.html, y se autovalida (sale 1 en un mapeo roto). Procede al siguiente paso tan pronto como salga 0 — sin edición manual de la especificación.
tokens.json sin colores/fuentes de marca (por ejemplo, sin captura) → el script mantiene la paleta propia del preset, un diseño completo y enviable. Si el resumen nombra colores/fuentes de marca que la captura pasó por alto, agrégalos a capture/extracted/tokens.json antes de ejecutar (o usa el design.md del usuario para poblarlo); solo ajusta frame.md manualmente después si un mapeo realmente lo necesita.
Compuerta: build-frame.mjs salió 0 — frame.md existe desde un preset nombrado, y (cuando el preset envía uno) .hyperframes/caption-skin.html existe como la fuente de la máscara de subtítulos.
Paso 3: Guion Gráfico y Script
Objetivo: Convertir el resumen y el material capturado en un plan de historia aprobado, fotograma por fotograma.
Lee references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md y ../hyperframes-core/references/script-format.md. Úsalos para escribir STORYBOARD.md y, cuando se necesite narración, SCRIPT.md.
Usa story-design.md para el plano de la historia, el gancho, la lógica de persuasión, los ritmos, VO_MODE y las elecciones de activos. Como guía suave, consulta el menú rol→plano en ../hyperframes-animation/blueprints-index.md: para cada ritmo, anota un ID de plano candidato cuando uno encaje. La verdad de la historia aún decide qué ritmos existen — nunca fuerces un ritmo para que encaje en un plano, y nunca inventes un ritmo solo porque una forma probada está disponible. Elige los asset_candidates de cada fotograma visual de capture/extracted/asset-descriptions.md (el inventario canónico) — no navegues por capture/assets/ en bruto. No pidas al usuario que elija activos a menos que ese inventario falte o sea inutilizable. Usa los campos exactos requeridos de las referencias de guion gráfico y script.
Después de redactar, muestra un resumen fotograma por fotograma. En ese mismo mensaje, pregunta al usuario dos cosas: (a) si aprueba o solicita cambios, y (b) si quiere una vista previa en vivo del andamio del guion gráfico (npx hyperframes preview) — ábrela solo si dice que sí. Itera hasta que se apruebe, y lleva la elección de vista previa al Paso 6.
Compuerta: STORYBOARD.md existe, cada fotograma visual tiene asset_candidates, SCRIPT.md existe cuando se necesita narración, y el usuario aprobó el plan fotograma por fotograma.
Paso 3.1: Audio
Objetivo: Generar narración, temporización de palabras, música y metadatos de audio a partir del script aprobado.
Comienza el audio después de la aprobación del Paso 3. Ejecútalo en segundo plano, luego continúa al Paso 4.
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
El script de audio maneja la narración, la temporización de palabras, la búsqueda de BGM de la biblioteca musical de HeyGen y los metadatos de temporización. El estado de ánimo del BGM proviene del campo music: del guion gráfico. Esto utiliza la API de Audio de HeyGen para recuperación, no generación, y usa la misma credencial ~/.heygen que TTS. Para detalles del proveedor, lee ../hyperframes-media/references/tts.md.
Si no hay narración y no hay SCRIPT.md, omite la generación de voz. El BGM aún puede ejecutarse si el guion gráfico tiene un estado de ánimo musical.
Compuerta: el trabajo de audio ha comenzado, o el proyecto está marcado como silencioso.
Paso 4: Diseño Visual del Fotograma
Objetivo: Añadir la dirección visual, la intención de diseño y las elecciones de movimiento a cada fotograma del guion gráfico.
Edita STORYBOARD.md en su lugar. No crees otro guion gráfico. Usa frame.md como fuente de verdad para color, tipo, sensación de diseño y estilo.
Lee references/visual-design.md, ../hyperframes-animation/blueprints-index.md, references/motion-language.md y ../hyperframes-animation/rules-index.md. Usa visual-design.md para el método (la secuencia de tomas con código de tiempo, el vocabulario de Diseño en línea y el bloque ## Video direction requerido). Usa ../hyperframes-animation/blueprints-index.md para elegir la forma de toma de cada fotograma. Usa motion-language.md (el vocabulario de movimiento + la doctrina de movimiento) y ../hyperframes-animation/rules-index.md (nombres de reglas válidos) para el movimiento — no inventes nombres de movimiento.
Para cada fotograma visual, escribe una secuencia de tomas con código de tiempo en STORYBOARD.md según el método de visual-design.md: elige el plano del fotograma (o compón), instáncialo con el contenido de ESTE producto, y ajusta el ritmo de revelación de cada Escena a la voz en off para que el fotograma se desarrolle en toda su duración en lugar de cargar todo al principio y luego congelarse. Indica el diseño y el movimiento en línea por Escena (vocabularios en visual-design.md y motion-language.md). Añade un bloque ## Video direction para todo el video.
No cambies la historia, el script, las elecciones de activos, asset_candidates, transition_in o el material fuente capturado. No escribas HTML en este paso.
Escenifica los activos nombrados después de que el diseño visual esté bloqueado:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
Compuerta: cada fotograma visual tiene una secuencia de tomas con código de tiempo cuyas revelaciones están sincronizadas con la voz en off (sin carga frontal); ## Video direction existe; assets/ contiene los activos nombrados.
Paso 5: Construir Fotogramas
Objetivo: Construir cada fotograma del guion gráfico como una composición HTML y ensamblar el video reproducible.
Espera a que finalice el audio del Paso 3.1 si se inició el audio. Luego sincroniza las duraciones y obtén los SFX; omite ambos si es silencioso.
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
La sincronización de duración es mecánica: la duración real de la voz gana; los fotogramas silenciosos mantienen las estimaciones; nunca edites manualmente las duraciones sincronizadas.
Antes del envío, lee sub-agents/frame-worker.md y ../hyperframes-core/references/subagent-dispatch.md. Despacha un sub-agente por fotograma, en paralelo si es posible; de lo contrario, ejecuta trabajadores en oleadas. Cada trabajador recibe exactamente un fotograma.
Cada contexto de trabajador debe incluir PROJECT_DIR, frame_id, el tamaño del lienzo, el estado de los subtítulos y la banda de exclusión si los subtítulos están habilitados, y RULES_DIR como la ruta absoluta a ../hyperframes-animation/rules/ de esta skill. Cada trabajador lee frame.md, su propio bloque ## Frame N de STORYBOARD.md, la receta de regla local (../hyperframes-animation/rules/<id>.md) para cada movimiento citado, y la plantilla del plano del fotograma (../hyperframes-animation/blueprints/<id>.md). Cada trabajador escribe solo compositions/frames/NN-*.html. Los trabajadores nunca deben editar STORYBOARD.md.
A medida que cada trabajador regresa, el orquestador marca ese fotograma como animated en STORYBOARD.md.
Después de que existan las temporizaciones de audio, construye los subtítulos en segundo plano y ensambla el índice:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
captions.mjs usa el .hyperframes/caption-skin.html del proyecto (copiado en el Paso 2) como el aspecto del subtítulo, inyectando los tokens de marca de frame.md; sin piel presente, renderiza la píldora predeterminada incorporada. captions: skipped (<razón>) es válido. Continúa sin subtítulos cuando se omitan explícitamente.
Compuerta: cada fotograma está marcado como animated, index.html existe, y los subtítulos están construidos u omitidos explícitamente.
Paso 6: Finalizar
Objetivo: Verificar el video ensamblado, obtener la aprobación del usuario y renderizar el MP4 final.
Inyecta transiciones, ejecuta comprobaciones, pausa para revisión, luego renderiza.
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes validate
npx hyperframes inspect
npx hyperframes snapshot --at <puntos-medios-de-fotograma>
snapshot une los fotogramas capturados en una hoja de contactos (snapshots/contact-sheet.jpg). Échale un vistazo; si nada está claramente roto, continúa — no te demores aquí.
Si un comando falla, muestra stderr y detente — no acumules comandos de recuperación. Arrégnalo tú mismo: la edición segura más barata en compositions/frames/NN-*.html, luego vuelve a ejecutar la comprobación fallida.
Después de que las comprobaciones pasen, pausa para la revisión del usuario. El video está ensamblado, visible y editable en Studio. Gestiona la vista previa solo una vez entre el Paso 3 y el Paso 6: ábrela si el usuario la pidió antes, ofrécela si la rechazó antes, y no preguntes de nuevo si ya está revisando en Studio.
Vista previa: npx hyperframes preview