Communitygithub.com

simpletibr/simplicio-loop-marketing

Monta um prompt de geração de vídeo selecionando o provedor via PROVIDERS.md e delegando ao construtor especializado correspondente.

O que é simplicio-loop-marketing?

Esta skill atua como um despachante genérico e independente de provedor para prompts de geração de vídeo. Ela lê a matriz de roteamento definida em `.specs/architecture/PROVIDERS.md`, determina qual provedor (Higgsfield, Topview, Wavespeed ou Hyperframes) deve executar a tarefa com base no `task_kind`, e delega a execução para a skill especialista correspondente. É útil para pipelines de vídeo que precisam de um único ponto de entrada para testes A/B, reexecução de briefs em diferentes provedores ou integração com orquestradores. A skill suporta plataformas como Claude Code, Cursor e Codex, e seu processo inclui verificação de variáveis de ambiente, tradução de campos do brief para o formato esperado pelo especialista, e logging de uso. Em caso de falha (como task_kind não mapeado ou env var ausente), ela aplica fallbacks e emite avisos, garantindo robustez sem retry automático em provedores alternativos.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construtor de Prompt de Vídeo

Despachante genérico e independente de provedor para prompts de geração de vídeo. Lê a matriz de roteamento em .specs/architecture/PROVIDERS.md, decide qual provedor deve executar a peça e delega para o especialista correto (higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder).

Quando Invocar

  • Qualquer etapa de geração de vídeo no pipeline (brief -> script -> creative quando o tipo criativo é vídeo).
  • Quando uma peça declara type: video em .specs/pieces/*.md.
  • Testes A/B de hooks de vídeo entre provedores e o orquestrador precisa de um único ponto de entrada.
  • Reexecução do mesmo brief em um provedor diferente após um vencedor de A/B ser escolhido.
  • Quando um agente upstream tem um brief mas não sabe qual provedor escolher.

Entradas

  • brief: objeto. Brief visual com pelo menos subject, motion, mood, aspect, duration_seconds.
  • task_kind: string. Um de cinematic_reel, motion_control, ugc_product_holder, product_demo, talking_head, batch_hook_test, motion_typography, data_viz_reel, programmatic_short.
  • piece_path: string, opcional. Caminho para o arquivo da peça. Pode conter provider_override.video.
  • dry_run: boolean, opcional. Quando verdadeiro, retorna o provedor resolvido e os parâmetros sem chamar o MCP.

Processo

  1. Ler .specs/architecture/PROVIDERS.md e analisar a matriz de Vídeo em um mapa de task_kind -> provider.
  2. Se piece_path estiver definido e contiver provider_override.video, usar a substituição.
  3. Caso contrário, procurar task_kind na matriz. Se desconhecido, usar o padrão da matriz para cinematic_reel.
  4. Verificar se o provedor escolhido possui as variáveis de ambiente definidas (HIGGSFIELD_MCP_ACTIVE, TOPVIEW_API_KEY, WAVESPEED_API_KEY, HYPERFRAMES_ACTIVE).
  5. Mapear provedor para skill especialista: Higgsfield -> higgsfield-prompt-builder, Topview -> topview-prompt-builder, Wavespeed -> wavespeed-batch, Hyperframes -> hyperframes-prompt-builder.
  6. Traduzir os campos do brief para a forma de entrada que o especialista espera.
  7. Invocar o especialista e capturar sua saída params e mcp_tool.
  8. Se dry_run, retornar o provedor resolvido, os params e a ferramenta MCP. Caso contrário, chamar o MCP e retornar a referência do artefato.
  9. Registrar a execução em data/video-usage.jsonl com timestamp, provedor, task_kind e resultado.

Saídas

  • provider_used: string.
  • params: objeto. Objeto de parâmetros final pronto para a chamada MCP.
  • mcp_tool: string. O nome da ferramenta MCP.
  • artifact_ref: string, quando não estiver em dry_run. Caminho ou URL para o vídeo gerado.
  • cost_estimate_usd: número.

Exemplos

Exemplo 1: reel cinematográfico roteado para Higgsfield

Entrada: { brief: { subject: "modelo em terno de linho", motion: "tracking shot", mood: "editorial", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" } Saída: { provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }

Exemplo 2: anúncio UGC roteado para Topview

Entrada: { brief: { subject: "frasco de skincare segurado por avatar", motion: "estático", mood: "amigável", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" } Saída: { provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }

Exemplo 3: reel semanal de KPI roteado para Hyperframes

Entrada: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" } Saída: { provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — renderização local via as skills hyperframes + hyperframes-cli.

Modos de Falha

  • task_kind não está na matriz: registrar um aviso e usar o padrão cinematic_reel.
  • Variável de ambiente necessária ausente para o provedor escolhido: cair para o próximo provedor na matriz e exibir um aviso.
  • Skill especialista retorna um erro: exibi-lo e não repetir automaticamente em um provedor diferente, a menos que o chamador opte por isso.
  • Duração excede o limite do provedor: truncar para o máximo do provedor e exibir um aviso.

Skills Relacionadas

  • higgsfield-prompt-builder: especialista para Soul, DoP, Seedance.
  • topview-prompt-builder: especialista para anúncios UGC e baseados em avatar.
  • wavespeed-batch: especialista para testes de hook em lote de baixo custo.
  • hyperframes-prompt-builder: especialista para tipografia animada renderizada em HTML, reels de visualização de dados e curtas programáticos parametrizados.
  • llm-router: despachante separado para geração de texto; mesmo padrão, domínio diferente.
  • qa-tech-specs: valida o vídeo final contra a especificação da plataforma.

Individual skills in this repo

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

Habilidades Relacionadas