Communitygithub.com

simpletibr/simplicio-loop-marketing

Traduz um briefing de peça do motor de marketing no formato de entrada esperado pela skill `hyperframes` (especificação de composição) e nos sinalizadores que a skill `hyperframes-cli` precisa para renderizá-lo. Selecionada por `video-prompt-builder` quando a matriz de roteamento resolve para o provedor `hyperframes`.

O que é simplicio-loop-marketing?

Esta skill atua como uma ponte entre o modelo de peça do motor de marketing (briefing, tipo de tarefa, substituição de provedor) e o contrato de composição do HyperFrames. Ela é especializada em preparar os dados de entrada para que as skills `hyperframes` e `hyperframes-cli` possam gerar vídeos animados, como reels de KPI, cartões de citação animados ou vídeos programáticos curtos. A skill carrega o contexto da marca (cores, tipografia, tom de voz) a partir de um arquivo de design do cliente, mapeia o tipo de tarefa para um modelo de composição pré-definido e declara todas as variáveis dinâmicas (headline, números, CTA) de forma explícita. Ela suporta execução dry-run para inspeção e, quando executada, orquestra a chamada do `hyperframes-cli` na sequência correta (lint, inspect, render). O resultado final é um caminho para o arquivo MP4 gerado localmente, sem custos diretos de computação em nuvem, apenas com uma estimativa de tempo de renderização.

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

Perguntar na sua IA favorita

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

Documentação

Construtor de Prompt HyperFrames

Especialista que faz a ponte entre o modelo de peça do motor de marketing (brief, task_kind, provider_override) e o contrato de composição do HyperFrames. Espelha higgsfield-prompt-builder e topview-prompt-builder na forma — mesmo despachante, alvo diferente — para que video-prompt-builder possa trocar de provedores sem alterar sua própria lógica.

Quando invocar

  • video-prompt-builder resolve o provedor de vídeo para hyperframes para uma peça.
  • task_kind é um de motion-typography, data-viz-reel, programmatic-short (as tarefas nativas do hyperframes em PROVIDERS.md).
  • Uma peça declara provider_override.video: hyperframes em seu frontmatter.
  • Um still aprovado (cartão de citação do gpt-image, carrossel do topview) está sendo promovido para movimento e o sistema de tipos deve permanecer fiel ao byte original.
  • O orquestrador precisa que a mesma composição seja re-renderizada com novos valores de variáveis (reel semanal de KPI, atualização diária de preço, variante de copy A/B) sem re-promptar um gerador de IA.

Entradas

  • brief: objeto. O briefing da peça com pelo menos headline, body?, cta?, aspect, duration_seconds.
  • task_kind: "motion-typography" | "data-viz-reel" | "programmatic-short".
  • piece_path: string, opcional. Caminho para .specs/pieces/<piece-id>.md. O frontmatter pode conter provider_override, compliance_flags, variables.
  • client_slug: string. Usado para carregar .marketing-engine/clients/<slug>/design.md (ou clients/<slug>/design.md no repositório do motor).
  • output_dir: string. Onde o projeto e o MP4 final serão salvos (padrão: outputs/<client>/<date>/<piece-id>/).
  • dry_run: boolean, opcional. Quando verdadeiro, retorna a especificação de composição e os argumentos de renderização sem invocar hyperframes-cli.

Processo

  1. Carregar contexto da marca. Ler clients/<client_slug>/design.md e resolver { colors, type_pairing, spacing_scale, brand_voice }. Se ausente, recusar prosseguir — exibir o caminho ausente. Violações de marca não podem ser corrigidas downstream.
  2. Resolver substituições. Se piece_path estiver definido e o frontmatter tiver provider_override.video, confirmar que é hyperframes; caso contrário, esta skill não deveria estar em execução.
  3. Mapear task_kind para um modelo de composição.
    • motion-typography → modelo kinetic-type, cena única, orientada por tipo.
    • data-viz-reel → modelo nyt-graph, cena de corpo com variáveis numéricas declaradas.
    • programmatic-short → modelo play-mode, gancho/corpo/CTA, toda a copy do cliente declarada como variáveis.
  4. Declarar variáveis. Tudo no briefing que poderia mudar por re-renderização (headline, corpo, números de KPI, CTA, carimbo de data) vai para variables com tipo + rótulo + padrão explícitos. Cópia codificada é proibida quando uma variável funcionaria.
  5. Construir a especificação de composição no formato que o hyperframes espera: { composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir }. Calcular composition_id a partir de <piece-id> (seguro para slug).
  6. Construir os argumentos de renderização no formato que o hyperframes-cli espera: { project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } }. Escolher quality: "high" para peças promovidas, "draft" para revisão de primeira passagem.
  7. Estimativa de custo. Renderização local — estimar a partir de duration_seconds × workers × $0.00 (zero custo direto; reportar minutos de tempo real como latency_estimate_min em vez disso).
  8. Registrar a resolução em data/video-usage.jsonl com { ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run }.
  9. Se dry_run, retornar sem chamar hyperframes-cli. Caso contrário, invocar hyperframes (para criar o projeto) e depois hyperframes-cli (modo lint → inspect → render) em ordem.

Saídas

  • provider_used: "hyperframes".
  • composition_spec: objeto. A entrada passada para a skill hyperframes.
  • render_args: objeto. A entrada passada para a skill hyperframes-cli (modo render).
  • expected_artifact: string. O caminho do MP4 que existirá após a renderização.
  • latency_estimate_min: número. Estimativa de tempo real para a renderização.
  • cost_estimate_usd: 0 (renderização local; apenas despesas operacionais).

Exemplos

Exemplo 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" } Saída: especificação de composição com composition_id: "kpi-weekly-2026-05-22", três cenas (gancho/corpo/CTA), variáveis numéricas (leads, delta_pct); argumentos de renderização com --strict --strict-variables --quality high --variables '{"leads":42,"delta_pct":12}'.

Exemplo 2: cartão de citação animado (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" } Saída: especificação de composição com uma única cena de tipo cinético, entrada de texto mascarada, tokens de design extraídos do design.md do cliente ativo; argumentos de renderização visando outputs/saas-consultoria-imagem/<date>/<piece-id>/final.mp4.

Exemplo 3: substituição de provedor

Entrada: uma peça com provider_override.video: hyperframes cujo task_kind não está na matriz. Saída: ainda roteada para cá, padrão task_kind para programmatic-short, registrar o fallback.

Regras inegociáveis

  • Nunca inventar tokens de design. Recusar prosseguir se design.md estiver ausente.
  • Sempre declarar a copy específica da peça como uma variable, mesmo que pareça estática — a composição deve poder ser re-renderizada sem edições de código.
  • Sempre passar --strict-variables nos argumentos de renderização. Um erro de digitação em um id de variável é uma falha grave.
  • Nunca chamar hyperframes-cli diretamente ignorando a sequência lint → inspect → render.

Modos de falha

  • task_kind desconhecido: padrão para programmatic-short, registrar um aviso e continuar.
  • design.md ausente: parar. Não escolher uma paleta; pedir ao operador para adicionar o arquivo.
  • Briefing inclui uma alegação proibida pela marca (conforme compliance-<cliente ativo>): bloquear antes de criar; a conformidade é executada upstream da renderização.
  • HyperFrames CLI não instalado: exibir o comando de instalação (npm i -g hyperframes ou npx hyperframes@latest) e parar.

Skills relacionadas

  • hyperframes: regras de criação de composição (consumidas por esta skill).
  • hyperframes-cli: execução de lint/inspect/render (consumidas por esta skill).
  • video-prompt-builder: despachante que seleciona esta skill.
  • qa-tech-specs: executa contra o MP4 final.
  • compliance-<cliente ativo> / compliance-generic: executa contra as variáveis resolvidas e o artefato renderizado.
  • llm-router: não usado diretamente aqui, mas pode escolher o LLM que redige a headline/corpo antes desta skill montar a especificação de composição.

Individual skills in this repo

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

Habilidades Relacionadas