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 fotograma a fotograma 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. Deriva otras intenciones a otro lugar: un tour general de un sitio web que no sea un lanzamiento ->
/website-to-video; un explicador de temas sin producto ->/faceless-explainer; un PR de GitHub ->/pr-to-video; subtítulos en metraje existente ->/embedded-captions; un gráfico en movimiento corto sin narración ->/motion-graphics. Si el usuario dice solo "haz un video" o la ruta es incierta, lee/hyperframesprimero.
Eres el orquestador. Trabaja en videos/<project>/. Ejecuta los pasos en orden y pasa cada compuerta antes de continuar. Los pasos controlados por el usuario son el Paso 0, el Paso 3 y el Paso 6. Haz tú mismo cada paso excepto el Paso 5, donde despachas un subagente por fotograma. No pongas reglas de diseño o movimiento aquí; esas viven en el subagente trabajador de fotogramas, en ../hyperframes-animation/rules/ local de esta skill + ../hyperframes-animation/blueprints/ y 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/guion -> 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 e index.html; Paso 6 renderizado final -> renders/video.mp4.
Paso 0: Configuración y Brief
Objetivo: Fijar el brief central del video y crear el proyecto HyperFrames si es necesario.
Inicializa solo si falta hyperframes.json. Nombra <project> a partir de la marca o dominio en formato kebab-case, como acme-promo; nunca uses el nombre del espacio de trabajo o una marca de tiempo.
npx hyperframes init "videos/<project>" --non-interactive --example=blank — init verifica las skills instaladas contra las últimas en GitHub y actualiza el conjunto global si alguna está desactualizada.
Muestra el estado de inicio de sesión antes del brief — 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 haya iniciado sesión, cómo hacerlo. Si no has 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 brief o cualquier otra cosa. Trátalo como un punto de decisión real, no como una nota pasajera; no incluyas la elección en la pregunta del brief, 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 obtener 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 fijados; 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. Guion/brief 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 subtitula automáticamente los activos en capture/extracted/asset-descriptions.md. Esto 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 del brief cuando sea posible. visible-text.txt contiene el brief o guion completo. asset-descriptions.md debe decir que no se capturaron activos a menos que el usuario haya dado notas de activos.
Compuerta: Existen capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md y capture/assets/; puedes enunciar la marca en una oración clara. Trata asset-descriptions.md como el inventario principal de activos. Si falta después de una 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 integrado; 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 adapte mejor a la marca y al brief. Luego ejecuta:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --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 se asignan 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 con 1 en un mapeo roto). Procede al siguiente paso tan pronto como salga con 0 — sin editar manualmente 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 brief nombra colores/fuentes de marca que la captura omitió, agrégalos a capture/extracted/tokens.json antes de ejecutar (o usa el design.md del usuario para completarlo); solo ajusta frame.md manualmente después si un mapeo realmente lo necesita.
Compuerta: build-frame.mjs salió con 0 — frame.md existe de un preset nombrado, y (cuando el preset incluye uno) .hyperframes/caption-skin.html existe como fuente de la máscara de subtítulos.
Paso 3: Guion Gráfico y Guion
Objetivo: Convertir el brief 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 beats, VO_MODE y las elecciones de activos. Como guía suave, consulta el menú rol→plano en ../hyperframes-animation/blueprints-index.md: para cada beat, anota un id de plano candidato cuando uno encaje. La verdad de la historia aún decide qué beats existen — nunca fuerces un beat para que encaje en un plano, y nunca inventes un beat 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 los capture/assets/ sin procesar. No le pidas al usuario que elija activos a menos que ese inventario falte o no sea utilizable. Usa los campos requeridos exactos de las referencias de guion gráfico y guion.
Después de redactar, muestra un resumen fotograma por fotograma. En ese mismo mensaje, pregunta al usuario dos cosas: (a) aprobar o solicitar cambios, y (b) si desean una vista previa en vivo del andamio del guion gráfico (npx hyperframes preview) — ábrelo solo con un sí. Itera hasta que esté aprobado y lleva la elección de la 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, tiempos de palabras, música y metadatos de audio a partir del guion 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, los tiempos de las palabras, la búsqueda de BGM de la biblioteca de música de HeyGen y los metadatos de sincronización. El estado de ánimo de BGM proviene del campo music: del guion gráfico. Esto usa 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 ni SCRIPT.md, omite la generación de voz. 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 opciones de movimiento a cada fotograma del guion gráfico.
Edita STORYBOARD.md en el lugar. No crees otro guion gráfico. Usa frame.md como fuente de verdad para el color, el tipo, la sensación del diseño y el 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 la revelación de cada Escena a la voz en off para que el fotograma se desarrolle a lo largo de su duración completa 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 guion, 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é fijado:
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 ajustadas al ritmo de la voz en off (sin carga frontal); existe ## Video direction; 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 el audio del Paso 3.1 termine 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 subagente por fotograma, en paralelo si es posible; de lo contrario, ejecuta trabajadores en oleadas. Cada trabajador recibe exactamente un fotograma.
El contexto de cada 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 los tiempos 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 de los subtítulos, inyectando tokens de marca de frame.md; sin máscara presente, renderiza la píldora predeterminada integrada. captions: skipped (<reason>) es válido. Continúa sin subtítulos cuando se omitan explícitamente.
Compuerta: cada fotograma está marcado como animated, existe index.html 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 <frame-midpoints>
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 lo pidió antes, ofrécela si la rechazó antes y no preguntes de nuevo si ya están revisando en Studio.
Vista previa: npx hyperframes preview
Render...