Communitygithub.com

simpleTibr/simplicio-loop-marketing - Constructor de Prompts de…

Ensambla un prompt de generación de video seleccionando el proveedor a través de PROVIDERS.md y delegando en el constructor específico del proveedor correspondiente.

¿Qué es simplicio-loop-marketing - Constructor de Prompts de…?

Este skill actúa como un despachador genérico y agnóstico al proveedor para prompts de generación de video. Su función principal es leer la matriz de enrutamiento definida en `.specs/architecture/PROVIDERS.md`, determinar qué proveedor (Higgsfield, Topview, Wavespeed o Hyperframes) debe ejecutar la pieza de video basada en el tipo de tarea (`task_kind`), y delegar el trabajo al constructor especializado correspondiente. Es útil porque unifica el punto de entrada en el pipeline de generación de video (desde el brief hasta el guion gráfico y el creativo), soporta pruebas A/B entre proveedores, maneja sobrescrituras de proveedor por pieza, y permite ejecuciones en seco para validar parámetros sin costo. Funciona en plataformas que soportan skills de agente como Claude Code, y se integra con skills especialistas como `higgsfield-prompt-builder`, `topview-prompt-builder`, `wavespeed-batch` y `hyperframes-prompt-builder`. El proceso incluye la validación de variables de entorno necesarias, la traducción de los campos del brief al formato esperado por cada especialista, la invocación del MCP correspondiente y el registro detallado de cada ejecución para trazabilidad.

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

Preguntar en tu IA favorita

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

Documentación

Constructor de Prompts de Video

Despachador genérico y agnóstico al proveedor para prompts de generación de video. Lee la matriz de enrutamiento en .specs/architecture/PROVIDERS.md, decide qué proveedor debe ejecutar la pieza y delega en el especialista correspondiente (higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder).

Cuándo invocarlo

  • Cualquier paso de generación de video en el pipeline (brief -> script -> creative cuando el tipo creativo es video).
  • Cuando una pieza declara type: video en .specs/pieces/*.md.
  • Pruebas A/B de hooks de video entre proveedores y el orquestador necesita un punto de entrada único.
  • Re-ejecutar el mismo brief en un proveedor diferente después de seleccionar un ganador de A/B.
  • Cuando un agente upstream tiene un brief pero no sabe qué proveedor elegir.

Entradas

  • brief: objeto. Brief visual con al menos subject, motion, mood, aspect, duration_seconds.
  • task_kind: cadena. Uno de cinematic_reel, motion_control, ugc_product_holder, product_demo, talking_head, batch_hook_test, motion_typography, data_viz_reel, programmatic_short.
  • piece_path: cadena, opcional. Ruta al archivo de la pieza. Puede contener provider_override.video.
  • dry_run: booleano, opcional. Cuando es verdadero, devuelve el proveedor resuelto y los parámetros sin llamar al MCP.

Proceso

  1. Leer .specs/architecture/PROVIDERS.md y analizar la matriz de Video en un mapa task_kind -> provider.
  2. Si piece_path está establecido y contiene provider_override.video, usar la sobrescritura.
  3. Si no, buscar task_kind en la matriz. Si es desconocido, usar el valor predeterminado de la matriz para cinematic_reel.
  4. Verificar que el proveedor elegido tenga las variables de entorno establecidas (HIGGSFIELD_MCP_ACTIVE, TOPVIEW_API_KEY, WAVESPEED_API_KEY, HYPERFRAMES_ACTIVE).
  5. Mapear proveedor a skill especialista: Higgsfield -> higgsfield-prompt-builder, Topview -> topview-prompt-builder, Wavespeed -> wavespeed-batch, Hyperframes -> hyperframes-prompt-builder.
  6. Traducir los campos del brief a la forma de entrada que espera el especialista.
  7. Invocar al especialista y capturar su params y salida mcp_tool.
  8. Si dry_run, devolver el proveedor resuelto, los parámetros y la herramienta MCP. De lo contrario, llamar al MCP y devolver la referencia del artefacto.
  9. Registrar la ejecución en data/video-usage.jsonl con marca de tiempo, proveedor, task_kind y resultado.

Salidas

  • provider_used: cadena.
  • params: objeto. Objeto de parámetros final listo para la llamada MCP.
  • mcp_tool: cadena. El nombre de la herramienta MCP.
  • artifact_ref: cadena, cuando no está en dry_run. Ruta o URL al video generado.
  • cost_estimate_usd: número.

Ejemplos

Ejemplo 1: reel cinematográfico enrutado a Higgsfield

Entrada: { brief: { subject: "modelo en traje de lino", motion: "travelling", mood: "editorial", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" } Salida: { provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }

Ejemplo 2: anuncio UGC enrutado a Topview

Entrada: { brief: { subject: "frasco de cuidado de la piel sostenido por avatar", motion: "estático", mood: "amigable", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" } Salida: { provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }

Ejemplo 3: reel semanal de KPI enrutado a Hyperframes

Entrada: { brief: { headline: "Semana 21 en números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" } Salida: { provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — renderizado local mediante los skills hyperframes + hyperframes-cli.

Modos de fallo

  • task_kind no está en la matriz: registrar una advertencia y usar el valor predeterminado de cinematic_reel.
  • Falta la variable de entorno requerida para el proveedor elegido: pasar al siguiente proveedor en la matriz y mostrar una advertencia.
  • El skill especialista devuelve un error: mostrarlo y no reintentar automáticamente en un proveedor diferente a menos que el llamador opte por ello.
  • La duración excede el límite del proveedor: recortar al máximo del proveedor y mostrar un aviso.

Skills relacionados

  • higgsfield-prompt-builder: especialista para Soul, DoP, Seedance.
  • topview-prompt-builder: especialista para UGC y anuncios impulsados por avatar.
  • wavespeed-batch: especialista para pruebas de hook por lotes de bajo costo.
  • hyperframes-prompt-builder: especialista para tipografía animada renderizada en HTML, reels de visualización de datos y cortos programáticos parametrizados.
  • llm-router: despachador separado para generación de texto; mismo patrón, dominio diferente.
  • qa-tech-specs: valida el video final contra las especificaciones de la plataforma.

Individual skills in this repo

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

Skills relacionados