Constructor de Prompts HyperFrames
Especialista que puentea el modelo de pieza de marketing-engine (brief, task_kind, provider_override) y el contrato de composición de HyperFrames. Se refleja en higgsfield-prompt-builder y topview-prompt-builder en forma — mismo despachador, diferente objetivo — por lo que video-prompt-builder puede cambiar de proveedores sin cambiar su propia lógica.
Cuándo invocarlo
video-prompt-builderresuelve el proveedor de video ahyperframespara una pieza.task_kindes uno demotion-typography,data-viz-reel,programmatic-short(las tareas nativas de hyperframes enPROVIDERS.md).- Una pieza declara
provider_override.video: hyperframesen su frontmatter. - Se promociona un still aprobado (tarjeta de cita de
gpt-image, carrusel detopview) a movimiento y el sistema de tipos debe mantenerse fiel al original a nivel de byte. - El orquestador necesita la misma composición renderizada nuevamente con nuevos valores de variables (reel semanal de KPI, actualización diaria de precio, copia de variante A/B) sin volver a solicitar a un generador de IA.
Entradas
brief: objeto. El brief de la pieza con al menosheadline,body?,cta?,aspect,duration_seconds.task_kind:"motion-typography" | "data-viz-reel" | "programmatic-short".piece_path: string, opcional. Ruta a.specs/pieces/<piece-id>.md. El frontmatter puede contenerprovider_override,compliance_flags,variables.client_slug: string. Se usa para cargar.marketing-engine/clients/<slug>/design.md(oclients/<slug>/design.mden el repositorio del motor).output_dir: string. Donde viven el proyecto y el MP4 final (por defectooutputs/<client>/<date>/<piece-id>/).dry_run: boolean, opcional. Cuando es true, devuelve la especificación de composición y los argumentos de renderizado sin invocarhyperframes-cli.
Proceso
- Cargar contexto de marca. Leer
clients/<client_slug>/design.mdy resolver{ colors, type_pairing, spacing_scale, brand_voice }. Si falta, negarse a continuar — mostrar la ruta faltante. Las violaciones de marca no se pueden corregir aguas abajo. - Resolver overrides. Si
piece_pathestá configurado y el frontmatter tieneprovider_override.video, confirmar que eshyperframes; de lo contrario, este skill no debería estar ejecutándose. - Mapear task_kind a una plantilla de composición.
motion-typography→ plantillakinetic-type, una sola escena, basada en tipografía.data-viz-reel→ plantillanyt-graph, escena principal con variables numéricas declaradas.programmatic-short→ plantillaplay-mode, gancho/cuerpo/CTA, toda la copia del cliente declarada como variables.
- Declarar variables. Cualquier cosa del brief que pueda cambiar por re-renderizado (headline, body, números de KPI, CTA, sello de fecha) va a
variablescon tipo explícito + etiqueta + valor por defecto. La copia hardcodeada está prohibida cuando una variable funcionaría. - Construir la especificación de composición en la forma que
hyperframesespera:{ composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir }. Calcularcomposition_ida partir de<piece-id>(seguro para slugs). - Construir los argumentos de renderizado en la forma que
hyperframes-cliespera:{ project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } }. Elegirquality: "high"para piezas promocionadas,"draft"para revisión de primer pase. - Estimación de coste. Renderizado local — estimar a partir de
duration_seconds × workers × $0.00(cero gastos de bolsillo; reportar tiempo de pared en minutos comolatency_estimate_minen su lugar). - Registrar la resolución en
data/video-usage.jsonlcon{ ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run }. - Si
dry_run, devolver sin llamar ahyperframes-cli. De lo contrario, invocarhyperframes(para autorizar el proyecto) y luegohyperframes-cli(modolint→inspect→render) en orden.
Salidas
provider_used:"hyperframes".composition_spec: objeto. La entrada pasada al skillhyperframes.render_args: objeto. La entrada pasada al skillhyperframes-cli(modorender).expected_artifact: string. La ruta del MP4 que existirá después derender.latency_estimate_min: número. Estimación de tiempo de pared para el renderizado.cost_estimate_usd: 0 (renderizado local; solo opex).
Ejemplos
Ejemplo 1: reel semanal de KPI (programmatic-short)
Entrada: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12 }, task_kind: "programmatic-short", client_slug: "saas-consultoria-imagem", piece_path: ".specs/pieces/2026-05-22-kpi.md" }
Salida: especificación de composición con composition_id: "kpi-weekly-2026-05-22", tres escenas (gancho/cuerpo/CTA), variables numéricas (leads, delta_pct); argumentos de renderizado con --strict --strict-variables --quality high --variables '{"leads":42,"delta_pct":12}'.
Ejemplo 2: tarjeta de cita en movimiento (motion-typography)
Entrada: { brief: { headline: "Coloque a sua marca onde os olhos já estão.", aspect: "1:1", duration_seconds: 6 }, task_kind: "motion-typography", client_slug: "saas-consultoria-imagem" }
Salida: especificación de composición con una única escena de tipo cinético, entrada de texto enmascarada, tokens de diseño extraídos del design.md del cliente activo; argumentos de renderizado que apuntan a outputs/saas-consultoria-imagem/<date>/<piece-id>/final.mp4.
Ejemplo 3: override de proveedor
Entrada: una pieza con provider_override.video: hyperframes cuyo task_kind no está en la matriz.
Salida: aún enrutado aquí, valor por defecto de task_kind a programmatic-short, registrar la caída.
Reglas no negociables
- Nunca inventar tokens de diseño. Negarse a continuar si falta
design.md. - Siempre declarar la copia por pieza como una
variable, incluso cuando parezca estática — la composición debe poder re-renderizarse sin ediciones de código. - Siempre pasar
--strict-variablesen los argumentos de renderizado. Un error tipográfico en un id de variable es un fallo duro. - Nunca llamar a
hyperframes-clidirectamente sin pasar por la secuencialint → inspect → render.
Modos de fallo
task_kinddesconocido: valor por defecto aprogrammatic-short, registrar una advertencia y continuar.design.mdfaltante: detenerse. No elegir una paleta; pedir al operador que agregue el archivo.- El brief incluye una afirmación prohibida por la marca (según
compliance-<cliente activo>): bloquear antes de autorizar; el cumplimiento se ejecuta aguas arriba del renderizado. - CLI de HyperFrames no instalado: mostrar el comando de instalación (
npm i -g hyperframesonpx hyperframes@latest) y detenerse.
Skills relacionados
hyperframes: reglas de autoría de composición (consumido por este skill).hyperframes-cli: ejecución de lint/inspect/render (consumido por este skill).video-prompt-builder: despachador que selecciona este skill.qa-tech-specs: se ejecuta contra el MP4 final.compliance-<cliente activo>/compliance-generic: se ejecuta contra las variables resueltas y el artefacto renderizado.llm-router: no se usa directamente aquí, pero puede elegir el LLM que redacta el headline/body antes de que este skill ensamble la especificación de composición.