Instalación del plugin: Antes de ejecutar comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando esta habilidad esté dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización que se indican a continuación.
Primero, mantén esta habilidad actualizada – confirma con el usuario antes de ejecutar:
npx hyperframes skills update product-launch-video. Una operación rápida sin cambios cuando todo está actualizado; de lo contrario, refresca esta habilidad y las habilidades 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 los assets existentes. Consulta la habilidad/media-use.
figma source: Si la fuente es una URL de figma.com, ejecuta
/figmaprimero — exportación de assets, tokens de marca y reconstrucción de componentes/storyboard si es necesario — y luego construye este flujo de trabajo a partir de su salida. No accedas a Figma directamente a través de herramientas MCP en bruto: eso omite la sanitización SVG, la procedencia.media/manifest.jsonly el enlace devar()de tokens de marca, por lo que un cambio posterior de marca no se puede propagar sin una reimportación completa.
Lanzamiento de Producto a HyperFrames
Usa esta habilidad para capturar un producto, comprender su marca, planificar un vídeo de lanzamiento y construirlo fotograma a fotograma 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 habilidad es para un producto que se comercializa, lanza, promociona o revela, incluyendo solicitudes como "promo para nuestro sitio" cuando el propósito es promocional. Una solicitud de recorrido/exhibición del sitio permanece aquí también:BRIEF.mdlleva la intención de mostrarlo tal cual, y las capturas de pantalla se convierten en los activos que presenta el vídeo. Cualquier otra intención, un simple "haz un vídeo" o cualquier incertidumbre → lee/hyperframesprimero — la capa de intención posee cada decisión de ruta, y una creación nueva que llegue aquí sinBRIEF.mdpasa por ella de todos modos (regla de apertura de Configuración).
Tú 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/references/brief-contract.md antes del Paso 0 — define los tipos de compuerta y cómo el flujo/storyboard de BRIEF.md derivan el modo que rige las compuertas de los Pasos 3/4/6. Haz tú mismo cada paso excepto el Paso 5, donde distribuyes un subagente por fotograma. No coloques reglas de diseño o movimiento aquí; esas viven en el subagente trabajador de fotogramas, en ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ locales de esta habilidad, 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 fotogramas -> compositions/frames/NN-*.html y index.html; Paso 6 renderizado final -> renders/video.mp4.
Paso 0: Configuración
Objetivo: Entrar con un briefing confirmado, crear el proyecto HyperFrames y hacer que el briefing sea duradero.
El briefing 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 briefing está resuelto, y su flujo/storyboard derivan el modo (contrato de briefing § 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 vuelvas a interrogar 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): comprueba recetas y valores predeterminados recordados, realiza las preguntas de esta ruta (../hyperframes/references/routes/product-launch-video.md) y devuelve el briefing bloqueado. Las solicitudes de edición omiten todo esto — ve a hacer la edición.
Inicializa solo si falta hyperframes.json. Nombra <proyecto> a partir de la marca o dominio en kebab-case, por ejemplo 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 comprueba las habilidades instaladas con las últimas 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 llamada.
Escribe BRIEF.md inmediatamente después de init (nunca antes — init rechaza un directorio no vacío): el briefing bloqueado de la capa de intención, con la forma según ../hyperframes/references/brief-format.md. Resuelve <MEDIA_DIR> como el directorio de la habilidad /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 ha 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 (contrato de briefing § 2); se mostró el estado de inicio de sesión (iniciada sesión, o continuando sin conexión).
Paso 1: Captura de activos
Objetivo: Recopilar el material fuente, las señales de marca y los activos utilizables para el vídeo.
Clasifica la entrada y elige la ruta. URL explícita -> captúrala y usa el sitio para la narración y los activos. Script/briefing 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 script (pregúntalo una vez aquí solo si el briefing 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 briefing dice que no se rasque) -> 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; en ese caso, 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 los subtítulos de imágenes opcionales estén desactivados intencionalmente.
Inspecciona inmediatamente el resultado del comando y el directorio de salida. Un código de salida distinto de cero, ok: false en JSON, 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 fabriques una alternativa sintética sin captura después de una captura de URL fallida. Continúa por la ruta sin captura solo cuando el briefing original proporcionó el material fuente, o cuando el usuario cambia explícitamente a una captura de pantalla o briefing 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 briefing de "mostrarlo tal cual", requiere una estructura capturada confiable o una captura de pantalla proporcionada; si no existe ninguna, detente. No inventes ni reconstruyas la página solo porque la captura no sea utilizable.
Para un recorrido del sitio o un briefing de "mostrarlo tal cual", la página capturada es la fuente visual de verdad. 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 la ventana gráfica sobre capture/screenshots/full-page.png — la placa 1x de todo el documento, con precisión de píxeles para una ventana gráfica de 1920 píxeles de ancho que se desplaza 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 1x requiere su propia captura 2x de esa región, ya que la placa no tiene margen por encima de 1x. Recrea toda la página solo cuando el usuario solicite explícitamente una interpretación estilizada; una captura no utilizable por sí sola no es una autorización.
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 briefing cuando sea posible. visible-text.txt contiene el briefing o script completo. asset-descriptions.md debe indicar que no se capturaron activos a menos que el usuario haya proporcionado notas sobre activos.
Compuerta: la captura JSON 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 se supera.
Paso 2: Sistema de Diseño
Objetivo: Elegir un preset de fotograma enviado; un script lo convierte en el frame.md + piel de subtítulos de este vídeo.
Cuando BRIEF.md nombra un style_preset — el usuario lo eligió visualmente de las muestras en la capa de intención — úsalo; la decisión es tuya solo cuando el briefing está en silencio. Luego, toma la única decisión — qué preset: lee ../hyperframes-creative/references/design-spec.md y elige el preset cuyo aspecto se adapte mejor a la marca y al briefing. 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 a las claves de color del preset por rol — tinta, lienzo, acentos — manteniendo claves/estructura/componentes; las fuentes de visualización + cuerpo del preset reemplazadas 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 briefing 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 incluye una) .hyperframes/caption-skin.html existe como la fuente de la piel de subtítulos; el preset elegido fue registrado como preferencia (--key style_preset --workflow <este flujo de trabajo>, contrato de briefing § 2).
Paso 3: Storyboard y Guion
Objetivo: Convertir el briefing y el material capturado en un plan de historia fotograma a fotograma aprobado.
Lee ../hyperframes-creative/references/story-spine.md (lenguaje de gancho, valor antes de la evidencia, storyboard como propuesta, elementos visuales trazables hasta la fuente), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md y ../hyperframes/references/script-format.md. Úsalos para escribir STORYBOARD.md y, cuando se necesite narración, SCRIPT.md. Establece el duration: del frontmatter a partir de la longitud del briefing — una expectativa aproximada; el ensamblaje informa dónde cae el corte en relación con ella.
Usa story-design.md para el plano de la historia, gancho, lógica de persuasión, latidos, VO_MODE y elecciones de activos. Como guía suave, consulta el menú rol→plano en ../hyperframes-animation/blueprints-index.md: para cada latido, anota un id 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 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 le 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 de plan del bucle de revisión — ../hyperframes/references/review-loop.md § 1: presenta el plan como una propuesta y haz las dos preguntas — aprobar o cambiar, y bocetos primero (recomendado) u omitir. La retroalimentación llega como una respuesta de chat; repite hasta que se apruebe. Esta es una compuerta de punto de control (contrato de briefing § 1): en modo autónomo}}rt_advanced_essay