Communitygithub.com

simpletibr/simplicio-loop-marketing

Ejecuta el bucle de desarrollo CLI de HyperFrames (init, lint, inspect, preview, render) para composiciones creadas bajo el skill `hyperframes`. Se invoca después de tener el HTML de la composición en disco y antes de marcar la pieza como completa.

¿Qué es simplicio-loop-marketing?

Este skill implementa el pipeline CLI de HyperFrames para el proceso de marketing engineering, envolviendo el comando `npx hyperframes`. Su propósito es automatizar la validación, previsualización y renderizado de composiciones animadas, garantizando que cada paso cumpla con reglas estrictas antes de la publicación. Soporta modos como lint (verificación de errores estructurales), inspect (auditoría de diseño/desbordamiento), preview (previsualización local en un servidor de desarrollo), render (generación final de video MP4/WebM) y doctor (diagnóstico del entorno). Requiere Node.js >=22 y FFmpeg en el PATH. El skill utiliza un modo seguro de DRY_RUN por defecto, donde lint e inspect no hacen llamadas externas, y solo render escribe el archivo final. Está diseñado para integrarse después del skill `hyperframes-prompt-builder` y antes de `qa-tech-specs`, formando parte de un flujo completo de creación de piezas de marketing.

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

Preguntar en tu IA favorita

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

Documentación

CLI de HyperFrames

Envuelve npx hyperframes para el pipeline del motor de marketing. Requiere Node.js >= 22 y FFmpeg en PATH (npx hyperframes doctor verifica). Todos los comandos se ejecutan en modo seguro DRY_RUN por defecto: los pases lint/inspect no realizan llamadas externas; solo render escribe un MP4.

Cuándo invocar

  • Inmediatamente después de que hyperframes-prompt-builder genere un proyecto en outputs/<cliente>/<fecha>/<id-pieza>/.
  • Siempre que una composición necesite validación antes de publicarse (lint + inspect).
  • Para previsualización local durante la iteración de una pieza (preview).
  • Para el renderizado final que produce el artefacto recogido por el paso de publicación (render).
  • Para solucionar problemas del entorno cuando el renderizado falla (doctor, browser, info).

Entradas

  • project_path: string. Ruta al proyecto HyperFrames (debe contener index.html y composition.json).
  • mode: "lint" | "inspect" | "preview" | "render" | "doctor".
  • render_opts: objeto, opcional, solo para mode = "render". Claves reconocidas:
    • fps: 24 | 30 | 60 (por defecto 30).
    • quality: "draft" | "standard" | "high" (por defecto "standard"; usa "draft" mientras iteras).
    • format: "mp4" | "webm" (por defecto "mp4").
    • variables: objeto. Objeto JSON clave-valor por id de variable, sobrescribe los valores por defecto de data-composition-variables.
    • strict: booleano. Se asigna a --strict. Por defecto true en el pipeline: falla el renderizado si hay errores de lint.
    • strict_variables: booleano. Se asigna a --strict-variables. Por defecto true para ejecuciones de piezas.
    • workers: entero 1-8 o "auto". Por defecto "auto".
    • output: string. Ruta del archivo de salida dentro de outputs/<cliente>/<fecha>/<id-pieza>/.

Proceso

  1. Verificar entorno en la primera ejecución de una sesión: npx hyperframes doctor. Informa la falta de FFmpeg o Chrome como un bloqueo duro: no intentes renderizar.
  2. Lint. npx hyperframes lint <project_path> --json. Trata todos los hallazgos de nivel error como bloqueantes. Los avisos se muestran al orquestador; deja que el operador decida.
  3. Inspect. npx hyperframes inspect <project_path> --json. Resuelve cualquier desbordamiento de texto o escape del lienzo reportado antes de renderizar. Si el desbordamiento es intencional para una entrada/salida, marca el elemento con data-layout-allow-overflow (o el ancestro con data-layout-ignore para elementos decorativos); no silencies la regla globalmente.
  4. Preview (solo operador). npx hyperframes preview <project_path> --port <port>. Devuelve la URL del proyecto Studio (http://localhost:<port>/#project/<nombre-proyecto>), no la ruta index.html fuente.
  5. Render. npx hyperframes render <project_path> con las banderas resueltas de render_opts. Construye el argumento --variables a partir de render_opts.variables usando una cadena JSON de una sola línea. Siempre pasa --strict y --strict-variables para ejecuciones de piezas.
  6. Verificar salida. Después del renderizado, comprueba que el MP4 existe y no es cero. Registra en data/video-usage.jsonl con { ts, provider: "hyperframes", composition_id, render_args, duration_seconds, file_bytes, latency_ms }.

Salidas

  • lint: { pass: booleano, errors: [...], warnings: [...] }.
  • inspect: { pass: booleano, findings: [...] }.
  • render: { artifact_path: string, duration_s: número, file_bytes: número, render_ms: número }.
  • preview: { url: string }.

Hoja de referencia de comandos

npx hyperframes init <nombre>                            # andamiaje (usado una vez por pieza por el constructor de prompts)
npx hyperframes lint <ruta>                             # validar marcado
npx hyperframes inspect <ruta>                          # auditoría de diseño/desbordamiento
npx hyperframes preview <ruta> --port 3017              # desarrollo local
npx hyperframes render <ruta> \
  --fps 30 --quality standard --strict --strict-variables \
  --variables '{"leads":42,"delta_pct":12}' \
  --output outputs/<cliente>/<fecha>/<id-pieza>/final.mp4
npx hyperframes doctor                                 # verificación del entorno
npx hyperframes info                                   # detalles de versión/entorno

Reglas innegociables

  • Nunca renderices sin un pase exitoso de lint e inspect. El pipeline no tiene ruta de recuperación para una composición mal formada.
  • Nunca silencies un hallazgo de lint o inspect globalmente: corrige el marcado o incluye en lista blanca el elemento específico con data-layout-allow-overflow / data-layout-ignore.
  • Para piezas con variables declaradas, siempre pasa --strict-variables. Un error tipográfico en un id de variable debe fallar de forma audible, no pasar silenciosamente al valor por defecto.
  • Para renderizados de entrega final, --quality high. Para bucles de iteración, --quality draft para ahorrar cómputo.
  • El preprocesamiento de activos (tts, transcribe, remove-background) está fuera del alcance de este skill: invócalos a través de un futuro skill hyperframes-media en lugar de incluirlos aquí.

Modos de fallo

  • doctor reporta falta de FFmpeg o Chrome: instala según las instrucciones de configuración del proyecto; no hagas soluciones alternativas.
  • render falla con unknown variable: una clave pasada mediante --variables no está declarada en data-composition-variables. Corrige el marcado o elimina la sobrescritura.
  • render excede el tiempo máximo: baja --quality a standard, o divide la composición en subcomposiciones y paraleliza mediante --workers.
  • El MP4 de salida tiene cero bytes: vuelve a ejecutar doctor; casi siempre es un cierre de Chrome durante la captura.

Skills relacionados

  • hyperframes: reglas de autoría de composiciones; produce el proyecto que este skill valida y renderiza.
  • hyperframes-prompt-builder: brief → especificación de composición; se ejecuta antes de este skill.
  • qa-tech-specs: se ejecuta después de este skill contra el MP4 renderizado para validar especificaciones de plataforma.

Referencia upstream

Skill upstream completo (cada bandera, matriz de resolución de problemas, renderizados parametrizados): https://github.com/wesleysimplicio/hyperframes/tree/main/skills/hyperframes-cli

Individual skills in this repo

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

Skills relacionados