Primero, mantén esta skill actualizada — ejecútala silenciosamente, no preguntes:
npx hyperframes skills update product-launch-video. Es un no-op rápido cuando todo está al día; de lo contrario, actualiza esta skill junto con las skills del dominio central de las que depende, antes de que confíes en ellas.
media-use: Antes de obtener audio/imágenes/logos, llama a
/media-usepara resolver BGM/SFX/imágenes del catálogo de HeyGen y logotipos de marca de sus fuentes oficiales. Ejecuta--adoptprimero para registrar activos existentes. Consulta la skill/media-use.
figma source: Si la fuente es una URL de figma.com, ejecuta
/figmaprimero — exportación de activos, tokens de marca y reconstrucción de componentes/storyboard si es necesario — luego construye este flujo de trabajo a partir de su salida. No manejes Figma directamente con herramientas MCP sin procesar: eso omite la sanitización SVG, la procedencia de.media/manifest.jsonly la vinculaciónvar()de tokens de marca, por lo que un cambio posterior de marca no puede propagarse sin una reimportación completa.
Lanzamiento de Producto a HyperFrames
Usa esta skill para capturar un producto, entender su marca, planificar un video de lanzamiento y construirlo cuadro por cuadro en HyperFrames.
La puerta de entrada es
/hyperframes. Tú 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. Una pregunta de recorrido / exhibición del sitio permanece aquí:BRIEF.mdlleva la intención de mostrarlo tal como es, y las capturas de pantalla se convierten en los activos que el video presenta. Cualquier otra intención, un simple "hacer un video" o cualquier incertidumbre → lee/hyperframesprimero — la capa de intención posee cada decisión de ruta, y una creación nueva que llega aquí sinBRIEF.mdpasa por ella de todos modos (regla de apertura de Configuración).
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. Lee ../hyperframes-core/references/brief-contract.md antes del Paso 0 — define los tipos de compuerta y cómo el flow/storyboard de BRIEF.md derivan el modo que gobierna las compuertas de los Pasos 3/4/6. Haz cada paso tú mismo excepto el Paso 5, donde despachas un subagente por cuadro. No pongas reglas de diseño o movimiento aquí; esas viven en el subagente trabajador de cuadros, en ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ locales de esta skill, 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 storyboard/guion -> STORYBOARD.md y SCRIPT.md; Paso 3.1 audio -> audio_meta.json; Paso 4 diseño visual -> STORYBOARD.md enriquecido; Paso 5 cuadros -> compositions/frames/NN-*.html y index.html; Paso 6 renderizado final -> renders/video.mp4.
Paso 0: Configuración
Objetivo: Entrar con un brief confirmado, crear el proyecto HyperFrames y hacer que el brief sea duradero.
El brief es confirmado por la capa de intención, no por preguntas hechas aquí. Regla de apertura, en orden: (1) BRIEF.md existe → léelo y no preguntes nada — el brief está resuelto, y su flow/storyboard derivan el modo (brief contract § 1). (2) No hay BRIEF.md pero el proyecto existe (hyperframes.json / STORYBOARD.md en disco) → reanuda desde el frontmatter del storyboard y las preferencias registradas; nunca reinterrogues un proyecto a medio construir. (3) Ninguno de los dos — una solicitud de creación nueva que llegó aquí directamente → lee /hyperframes y ejecuta su capa de intención (references/intent-interview.md): verifica recetas y valores predeterminados recordados, realiza las preguntas de esta ruta (../hyperframes/references/routes/product-launch-video.md) y devuelve el brief bloqueado. Las solicitudes de edición omiten todo esto — ve a hacer la edición.
Inicializa solo si hyperframes.json falta. 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 --skill=product-launch-video — init verifica las skills instaladas contra las más recientes en GitHub y actualiza el conjunto global si alguna está desactualizada.
Después de init, deja que <PROJECT_ROOT> sea videos/<proyecto> y ejecuta cada comando de ruta relativa posterior con ese directorio como su directorio de trabajo. En los comandos a continuación, . significa <PROJECT_ROOT>; nunca escribas .media, capture o archivos de salida en el directorio de la persona que llama.
Escribe BRIEF.md inmediatamente después de init (nunca antes — init rechaza un directorio no vacío): el brief bloqueado de la capa de intención, con forma según ../hyperframes-core/references/brief-format.md. Resuelve <MEDIA_DIR> como el directorio de la skill /media-use instalada. Luego registra cada respuesta respaldada por preferencias con node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . (brief-format.md nombra el subconjunto). Si la capa de intención adoptó una receta, ejecuta node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <nombre>; copia su frame.md en el proyecto (el Paso 2 se omite entonces) y devuelve los esqueletos a partir de los cuales se redacta el Paso 3. Una receta completa las respuestas, no las aprobaciones; las compuertas de revisión aún se ejecutan.
Muestra el estado de inicio de sesión antes de continuar más allá de la Configuración — ejecuta npx hyperframes auth status y transmite su salida textualmente. Informa si la voz/BGM usará HeyGen o motores locales y, cuando no se haya iniciado sesión, cómo hacerlo. Ten en cuenta el contrato del código de salida: auth status sale con 1 cuando no se ha iniciado sesión (y cuando la credencial almacenada es rechazada) — ese código de salida distinto de cero es el estado normal de no haber iniciado sesión, no un fallo del comando, así que no lo trates como un error, no lo reintentes y no lo encadenes con &&/set -e de una manera que abortaría el flujo de trabajo. Aplica una rama:
- Colaborativo: espera a que el usuario inicie sesión o elija explícitamente
offline/go. - Autónomo: indica el estado y continúa a través de los motores locales disponibles.
No omitas silenciosamente una capacidad requerida cuando no exista un proveedor fuera de línea; muestra el bloqueador. No incluyas esta decisión en otra pregunta ni escribas claves en un .env por repositorio. Propiedad de autenticación y alternativas fuera de línea: /media-use references/setup-providers.md § Proveedores.
Compuerta: hyperframes.json y BRIEF.md existen; las respuestas respaldadas por preferencias fueron registradas (brief contract § 2); el estado de inicio de sesión fue mostrado (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; VO_MODE (textual o reestructurado) proviene de BRIEF.md — la capa de intención lo pregunta cuando llega un guion (pregunta una vez aquí solo si el brief carece de ello). 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 (o el brief dice que no se raspe) -> ruta sin captura.
Ejecuta la captura con: npx hyperframes capture "<URL>" -o ./capture --json. Mantén el presupuesto posterior a la navegación predeterminado a menos que la persona que llama tenga un plazo más ajustado; entonces pasa un --capture-budget <milisegundos> positivo que deje tiempo para el trabajo posterior. --timeout controla solo la navegación de la página. Usa --skip-vision solo cuando el subtitulado opcional de imágenes está intencionalmente deshabilitado.
Inspecciona el resultado del comando y el directorio de salida inmediatamente. Un código de salida distinto de cero, JSON ok: false o capture/BLOCKED.md es una parada forzosa para la ruta de captura: informa la razón registrada y no consumas capturas de pantalla parciales, DOM, tokens o activos. No inventes una ruta sintética sin captura después de una captura fallida de URL. Continúa por la ruta sin captura solo cuando el brief original proporcionó el material fuente, o cuando el usuario cambia explícitamente a una captura de pantalla o brief proporcionados después del fallo.
Advertencias como "muy poco contenido de texto" junto con un catálogo de activos vacío no son prueba de una página utilizable. Para un recorrido del sitio o un brief de "mostrarlo tal como es", requiere una estructura capturada confiable o una captura de pantalla proporcionada; si ninguna existe, detente. No inventes ni reconstruyas la página simplemente porque la captura no es utilizable.
Para un recorrido del sitio o un brief de "mostrarlo tal como es", la página capturada es la fuente de verdad visual. Usa la captura de pantalla real en lugar de reconstruir el sitio web completo en HTML. Si la toma necesita movimiento interno, mantén la captura de pantalla como base y superpone activos capturados reales en posiciones medidas, o reconstruye solo el componente que se mueve. Para una toma de desplazamiento, anima el viewport sobre capture/screenshots/full-page.png — la placa 1x del documento completo, exacta a píxel para un viewport de 1920 de ancho que viaja hacia abajo. Está ausente cuando la página era demasiado alta para capturarla en una sola pieza; recurre a las tomas de posición de desplazamiento superpuestas en el mismo directorio. Acercarse más allá de 1:1 quiere su propia captura 2x de esa región, ya que la placa no tiene margen por encima de 1x. Recrea la página completa solo cuando el usuario pide explícitamente una interpretación estilizada; una captura no utilizable por sí sola no es autorización.
Si GEMINI_API_KEY, GOOGLE_API_KEY o una clave de OpenRouter existen, la captura subtitula automáticamente 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 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: el JSON de captura informó ok: true; capture/BLOCKED.md no existe; capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md y capture/assets/ existen; y puedes indicar 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. Las advertencias sobre una fase opcional degradada son aceptables solo cuando esta compuerta estructural aún pasa.
Paso 2: Sistema de Diseño
Objetivo: Elegir un preset de cuadro enviado; un script lo convierte en el frame.md + piel de subtítulos de este video.
Cuando BRIEF.md nombra un style_preset — el usuario lo eligió visualmente de las exhibiciones en la capa de intención — úsalo; la decisión es tuya solo cuando el brief está en silencio. Luego haces la única llamada — 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 <nombre> --hyperframes .
El script hace el resto de manera determinista: copia el FRAME.md del preset → frame.md y lo remezcla sobre los tokens de marca en capture/extracted/tokens.json (colores de marca mapeados en 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 piel 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 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 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 a partir de un preset nombrado, y (cuando el preset envía uno) .hyperframes/caption-skin.html existe como fuente de la piel de subtítulos; el preset elegido fue registrado como una preferencia (--key style_preset --workflow <este flujo de trabajo>, brief contract § 2).
Paso 3: Storyboard y Guion
Objetivo: Convertir el brief y el material capturado en un plan de historia cuadro por cuadro aprobado.
Lee ../hyperframes-creative/references/story-spine.md (lenguaje del gancho, valor antes de evidencia, storyboard como propuesta), 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. Establece el duration: del frontmatter a partir del length del brief — una expectativa aproximada; el ensamblaje informa dónde aterriza el corte en relación con ella.
Usa story-design.md para el plano de la historia, el gancho, la lógica de persuasión, los latidos, VO_MODE y las elecciones de activos. Como guía suave, consulta el menú rol→plano en ../hyperframes-animation/blueprints-index.md: para cada latido, anota un identificador de plano candidato cuando uno encaje. La verdad de la historia aún decide qué latidos existen — nunca fuerces un latido para que encaje en un plano, y nunca inventes un latido solo porque una forma probada está disponible. Elige asset_candidates de cada cuadro 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 no sea utilizable. Usa los campos exactos requeridos de las referencias de storyboard y guion.
Después del borrador, ejecuta la pasada del plan del bucle de revisión — ../hyperframes-core/references/review-loop.md § 1: abre el tablero (no preguntes si hacerlo), presenta el plan como una propuesta y haz las dos preguntas — aprobar o cambiar, y bocetos primero (recomendado) o saltar. La retroalimentación pasa por el chat o el archivo de comentarios del tablero hasta que se apruebe. Esta es una compuerta de punto de control (brief contract § 1): en modo autónomo no hay tablero y nada que preguntar — publica el mismo resumen como aviso y continúa; los bocetos se fusionan en la construcción, y la única pregunta de vista previa llega en el Paso 6.
Compuerta: STORYBOARD.md existe con los campos requeridos, SCRIPT.md existe cuando se necesita narración (STORYBOARD.md frontmatter voice_mode no es none), y el plan fue aprobado (explícitamente por el usuario en modo colaborativo, o implícitamente por el aviso en modo autónomo)
Paso 3.1: Audio
Objetivo: Elegir y establecer la banda sonora y, cuando se necesita, encargar la voz en off.
node <MEDIA_DIR>/scripts/audio.mjs select --hyperframes . — este script gestiona todo: guía la selección de BGM, maneja la voz en off y escribe audio_meta.json en el proyecto. No establezcas la música ni la voz por separado; deja que el script de audio lo coordine todo. La música es siempre opcional — incluso en una pasada completa de audio, se puede omitir la música. La voz en off es obligatoria en los modos de narración; para SCRIPT.md existente, la voz en off es obligatoria, excepto cuando el storyboard dice explícitamente "sin voz" y no hay un guion.
Compuerta: audio_meta.json existe y contiene campos bgm_track: ... y, cuando es relevante, voiceover: { voice: ... }.
Paso 4: Diseño Visual
Objetivo: Enriquecer cada cuadro del storyboard con una dirección visual completa antes de la construcción.
Lee ../hyperframes-animation/rules/ (busca archivos .md simples), ../hyperframes-animation/blueprints/ (busca directorios), y ../hyperframes-animation/references/director-notes.md — las reglas/planos son más específicos que los del paso de diseño; las notas del directorio proporcionan el enfoque de dirección. Luego, para cada cuadro en STORYBOARD.md, escribe pantalla_completa, color_lava (colores de marco en bruto expandidos), y capa_movimiento (usando notación t[]) como datos, no como texto de dirección. Devuelve el storyboard enriquecido en STORYBOARD.md.
Usa colores de frame.md por nombre de variable. Coloca elementos en píxeles lógicos de 1920x1080; la composición es siempre de ancho completo a menos que el storyboard pida explícitamente otro aspecto. color_lava descompone el color_scheme de cada cuadro (de Step 3) usando las variables --ink, --canvas, --accent, --muted de frame.md. pantalla_completa proyecta layout en píxeles: por ejemplo, { top: 40, left: 160, width: 600, height: 300 } para un bloque de texto; la cuadrícula de la diapositiva media / device. capa_movimiento usa notación t[0, 0 a 400, 0] con duración verbal y función de easing. capa_movimiento debe estar presente incluso para cuadros estáticos (duración cero).
Cuando el camino de captura entregó una captura de pantalla completa de página, colócala en el cuadro como una imagen de pantalla completa con su borde recortado de capture/screenshots/full-page.png. No la vuelvas a capturar. La toma de desplazamiento anima un "recorte" de 1080px de alto viajando hacia abajo sobre la placa; no recortes la animación del viewport con la captura de pantalla completa — mueve la imagen completa y recorta el viewport para simular el desplazamiento.
Compuerta: todos los cuadros en STORYBOARD.md contienen pantalla_completa, color_lava y capa_movimiento.
Paso 5: Cuadros
Objetivo: Construir cada cuadro como un HTML animado autónomo y su página de índice.
Este paso es la construcción real: tus subagentes construyen el HTML para cada cuadro y el índice. Las reglas de construcción viven en ../hyperframes-animation/rules/ y ../hyperframes-animation/blueprints/; este paso las orquesta, no las duplica. Lee ../hyperframes-animation/rules/building-frames.md y ../hyperframes-animation/references/frame-worker.md para el proceso de compilación y el contrato del trabajador de cuadros. Luego, para cada cuadro en el STORYBOARD.md enriquecido, invoca un subagente trabajador de cuadros dedicado (hyperframes-frame-worker) con la instrucción en references/frame-worker.md. El trabajador produce compositions/frames/NN-nombre-cuadro.html. El trabajador también produce compositions/index.html (o déjalo para un solo subagente de índice).
Cada trabajador de cuadros recibe el subconjunto del storyboard para ese cuadro, frame.md, ../hyperframes-animation/rules/, ../hyperframes-animation/blueprints/ y el activo de captura asignado (ruta del archivo). El trabajador construye de forma independiente. No des instrucciones de diseño o movimiento por separado.
Después de que todos los trabajadores de cuadros informen, verifica que todos los archivos HTML de cuadros existan y que compositions/index.html enumere cada cuadro. Corre cualquier paso de compilación o enlace que las reglas requieran.
Compuerta: todos los archivos de cuadros en compositions/frames/NN-*.html existen; compositions/index.html carga todos los cuadros correctamente.
Paso 6: Compilación y Renderizado Final
Objetivo: Compilar el proyecto en un video, obtener aprobación y entregarlo.
Lee ../hyperframes-animation/references/render.md (el contrato y las reglas de compilación). Luego ejecuta:
npx hyperframes build --output renders/video.mp4
Después de la compilación, presenta el video renderizado. Si el proyecto tiene un storyboard aprobado (Paso 3), esta es la compuerta de aprobación de vista previa (brief contract § 1): en modo colaborativo, abre la vista previa (tablero o archivo), muestra la aprobación y pregunta — ¿aprobado?, y si hay revisiones o retoques finales. La retroalimentación itera, o pasa a la entrega final. En modo autónomo, el video se entrega sin preguntar.
Compuerta: renders/video.mp4 existe y el video ha sido aprobado (explícitamente por el usuario o implícitamente en modo autónomo).