Communitygithub.com

simpletibr/simplicio-loop-marketing

Traduce un brief de pieza de marketing-engine a la forma de entrada que espera el skill 'hyperframes' (especificación de composición) y las banderas que necesita el skill 'hyperframes-cli' para renderizarlo. Es seleccionado por 'video-prompt-builder' cuando la matriz de enrutamiento se resuelve al proveedor 'hyperframes'.

¿Qué es simplicio-loop-marketing?

Este skill actúa como un puente entre el modelo de pieza de 'marketing-engine' (brief, task_kind, provider_override) y el contrato de composición de HyperFrames. Su propósito es traducir un brief de pieza de video en la especificación de composición que espera el skill 'hyperframes' y los argumentos de renderizado que necesita 'hyperframes-cli'. Es fundamental para que el despachador 'video-prompt-builder' pueda cambiar de proveedor de video sin modificar su lógica interna, simplemente delegando en este skill para el proveedor 'hyperframes'. El skill carga el contexto de la marca desde archivos de diseño, resuelve overrides, mapea el tipo de tarea a una plantilla de composición (como 'kinetic-type', 'nyt-graph' o 'play-mode'), declara variables para permitir re-renderizados sin editar código, y construye tanto la especificación de composición como los argumentos de CLI. Soporta modos de dry-run, genera estimaciones de coste y latencia, y se integra con otros skills para cumplimiento y control de calidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/simpletibr/simplicio-loop-marketing/tree/HEAD/.skills/hyperframes-prompt-builder

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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-builder resuelve el proveedor de video a hyperframes para una pieza.
  • task_kind es uno de motion-typography, data-viz-reel, programmatic-short (las tareas nativas de hyperframes en PROVIDERS.md).
  • Una pieza declara provider_override.video: hyperframes en su frontmatter.
  • Se promociona un still aprobado (tarjeta de cita de gpt-image, carrusel de topview) 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 menos headline, 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 contener provider_override, compliance_flags, variables.
  • client_slug: string. Se usa para cargar .marketing-engine/clients/<slug>/design.md (o clients/<slug>/design.md en el repositorio del motor).
  • output_dir: string. Donde viven el proyecto y el MP4 final (por defecto outputs/<client>/<date>/<piece-id>/).
  • dry_run: boolean, opcional. Cuando es true, devuelve la especificación de composición y los argumentos de renderizado sin invocar hyperframes-cli.

Proceso

  1. Cargar contexto de marca. Leer clients/<client_slug>/design.md y 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.
  2. Resolver overrides. Si piece_path está configurado y el frontmatter tiene provider_override.video, confirmar que es hyperframes; de lo contrario, este skill no debería estar ejecutándose.
  3. Mapear task_kind a una plantilla de composición.
    • motion-typography → plantilla kinetic-type, una sola escena, basada en tipografía.
    • data-viz-reel → plantilla nyt-graph, escena principal con variables numéricas declaradas.
    • programmatic-short → plantilla play-mode, gancho/cuerpo/CTA, toda la copia del cliente declarada como variables.
  4. Declarar variables. Cualquier cosa del brief que pueda cambiar por re-renderizado (headline, body, números de KPI, CTA, sello de fecha) va a variables con tipo explícito + etiqueta + valor por defecto. La copia hardcodeada está prohibida cuando una variable funcionaría.
  5. Construir la especificación de composición en la forma que hyperframes espera: { composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir }. Calcular composition_id a partir de <piece-id> (seguro para slugs).
  6. Construir los argumentos de renderizado en la forma que hyperframes-cli espera: { project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } }. Elegir quality: "high" para piezas promocionadas, "draft" para revisión de primer pase.
  7. 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 como latency_estimate_min en su lugar).
  8. Registrar la resolución en data/video-usage.jsonl con { ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run }.
  9. Si dry_run, devolver sin llamar a hyperframes-cli. De lo contrario, invocar hyperframes (para autorizar el proyecto) y luego hyperframes-cli (modo lint → inspect → render) en orden.

Salidas

  • provider_used: "hyperframes".
  • composition_spec: objeto. La entrada pasada al skill hyperframes.
  • render_args: objeto. La entrada pasada al skill hyperframes-cli (modo render).
  • expected_artifact: string. La ruta del MP4 que existirá después de render.
  • 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-variables en los argumentos de renderizado. Un error tipográfico en un id de variable es un fallo duro.
  • Nunca llamar a hyperframes-cli directamente sin pasar por la secuencia lint → inspect → render.

Modos de fallo

  • task_kind desconocido: valor por defecto a programmatic-short, registrar una advertencia y continuar.
  • design.md faltante: 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 hyperframes o npx 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.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Skills relacionados