CommunityImagemgithub.com

Agente de Design de Anúncios Estáticos

Transforme um kit de marca (cores, fontes, logotipo, capturas de tela ou MASTER_CONTEXT.md) mais uma oferta ou ângulo em carrosséis do Instagram finalizados (1080x1350 / 1080x1080), anúncios estáticos de imagem para redes sociais pagas (1080x1080, 1080x1350, 1080x1920, 1200x628), banners e miniaturas de vídeo (1920x1080) — com verificação de qualidade visual e de copy determinística e um quadro de revisão HTML interativo.

O que é Agente de Design de Anúncios Estáticos?

Este agente, chamado 'Agente de Design de Anúncios Estáticos', é a contraparte estática do 'mrpaidsocial-video-editor-agent'. Especializado em criar ativos visuais para campanhas de marketing digital, ele aceita um kit de marca (como um arquivo MASTER_CONTEXT.md) e uma oferta ou ângulo de marketing. O agente produz carrosséis para Instagram, anúncios de imagem estática em vários formatos (incluindo Feed, Portrait, Story, e Landscape), banners e thumbnails de vídeo. O processo segue um pipeline de cinco estágios: ingestão de tokens de marca, planejamento de ângulos e arquétipos de anúncio, construção de composições visuais, renderização para PNG, e uma rigorosa etapa de garantia de qualidade (QA). O QA é determinístico e verifica integridade de pixels, zonas seguras, conformidade com frases proibidas e densidade de copy. Finalmente, um quadro de revisão visual interativo é gerado, permitindo a aprovação ou rejeição de cada ativo. Ferramentas como Python (Pillow), HTML/CSS, JavaScript e scripts de linha de comando são usadas. O agente suporta as plataformas mais comuns (Instagram, Facebook, TikTok, LinkedIn) e é útil para profissionais de marketing e designers que precisam de uma produção visual confiável e em lote, com verificações de qualidade automáticas para evitar erros de layout e claims inválidos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/uzowurumauritius-rgb/growth-ops-agent-skills/tree/HEAD/skills/static-ad-design-agent

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Agente de Design de Anúncios & Gráficos Estáticos (static-ad-design-agent)

Entrada: Kit de marca (MASTER_CONTEXT.md, URL do site, paleta, fontes, logotipo ou capturas de tela do produto) + oferta/ângulo
Saída: Carrosséis do Instagram finalizados, Anúncios de Imagem Estática (Feed, Retrato, História, Paisagem), Banners, Miniaturas, Verificação de Qualidade Visual e de Copy Determinística (_qa/qa-report.json) e um Quadro de Revisão Visual Interativo (review/index.html).

Esta skill é a pacote irmão estático de mrpaidsocial-video-editor-agent. Ela segue a mesma cultura: verificar pixels, zonas seguras e conformidade de claims — não intenções.


O Pipeline em Resumo

(0) Ingestão e Tokens de Marca (MASTER_CONTEXT.md + oferta/ângulo)
        │
        ▼
(1) Plano de Ângulo e Arquétipo ──→ ads-manifest.json (variantes, carrosséis, copy, UTMs)
        │
        ▼
(2) Construção da Composição ───────→ Artboards em HTML/CSS ou Pillow/SVG a partir de ad-canvas-starter.html
        │
        ▼
(3) Rasterizar para PNG ────────→ 1080x1350 (4:5), 1080x1080 (1:1), 1080x1920 (9:16), 1200x628, 1920x1080
        │
        ▼
(4) Loop de QA Determinístico ───→ python3 scripts/qa_static_ads.py (pixels, zonas seguras, claims proibidas)
        │
        ▼
(5) Quadro de Revisão Interativo → python3 scripts/build_ad_review_board.py → review/index.html

Estágio 0 — Ingestão e Tokens de Marca

  1. Verifique a existência de MASTER_CONTEXT.md na raiz do workspace atual (ou copie de MASTER_CONTEXT.template.md).
  2. Extraia:
    • Tokens de marca: --bg-ink, --bg-paper, --accent-primary, --accent-secondary, --accent-alert, fontes de título/corpo, logotipo e capturas de tela reais do produto.
    • Diretrizes: banned_phrases e regras de vocabulário canônico.
  3. Confirme ou defina como padrão o pacote a ser entregue:
    • Pacote de Carrossel: 5–7 slides em 1080×1350 (4:5 — máximo espaço vertical do feed).
    • Trio de Anúncio Estático: 1080×1350 (4:5 Feed), 1080×1080 (1:1 Quadrado), 1080×1920 (9:16 História/Reel).
    • Banner / Miniatura: 1200×628 (Anúncio Link/Display) ou 1920×1080 (Miniatura de Vídeo).
  4. Crie a pasta de trabalho da campanha:
    outputs/<campaign-slug>/
    ├── ads-manifest.json
    ├── artboards/
    ├── renders/
    ├── _qa/
    └── review/
    

Estágio 1 — Plano de Ângulo e Arquétipo (ads-manifest.json)

Leia references/archetypes-and-safe-zones.md antes de criar os cards. Escolha entre os 10 arquétipos comprovados de anúncios estáticos e carrosséis:

  1. Desmentido com Carimbo Errado (Captura de tela/claim com carimbo nítido ERRADO ou MITO → card de verdade)
  2. Comparação Dividida Nós vs. Eles (Tabela de contraste de 2 colunas: Método Antigo vs. Método da Marca)
  3. Prova de UI do Produto Anotada (Captura de tela real do produto ou card com 3 pills de destaque ampliadas)
  4. Pilha de Custo/Tempo Acumulado (Recibo empilhado de custos/horas ocultos vs. 1 solução limpa)
  5. Diagrama de Mecanismo de 3 Etapas (Entrada → Motor → Resultado com selos numerados)
  6. Herói de Estatística + Fonte Citada (Chamada de métrica massiva + faixa de citação textual na parte inferior)
  7. Card de Gate Lista de Verificação ("Não se candidate/não lance até verificar estas 4 caixas")
  8. Card de Estado Antes / Depois (Estado sobrecarregado/disperso → estado de roteiro estruturado)
  9. Carrossel Narrativo de 5–7 Slides (Slide 1 Gancho → Slide 2 Agitação/Dados → Slides 3–5 Valor Acionável + Prova do Produto → Slide 6 Lista de Verificação Resumo → Slide 7 CTA)
  10. Miniatura / Banner de Alto Contraste (Frase de 3–5 palavras + assunto focal/UI + selo de contraste)

Escreva outputs/<campaign-slug>/ads-manifest.json aderindo ao esquema verificado por scripts/qa_static_ads.py:

{
  "campaign_slug": "sa-bursary-deadlines-q4",
  "brand_name": "Gradwyn",
  "offer_angle": "Não perca os prazos de bolsas de engenharia e ciência da computação na África do Sul porque os requisitos estão enterrados em 40 PDFs.",
  "cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
  "banned_phrases": [
    "admissão garantida",
    "bolsa garantida",
    "chance de entrar",
    "probabilidade de admissão"
  ],
  "brand_palette": ["#0c1a17", "#f6f1e8", "#1a6b5c", "#c4892a", "#c45c4a"],
  "creatives": [
    {
      "id": "carousel-01",
      "type": "carousel",
      "archetype": "carrossel-narrativo-5-slides",
      "format": "4:5",
      "width": 1080,
      "height": 1350,
      "primary_text": "A maioria dos estudantes perde bolsas não por causa das notas—mas porque as descobrem 2 semanas após o prazo ter fechado.",
      "headline": "Veja bolsas combinadas com seu Perfil de Estudante",
      "cta_label": "Saiba Mais",
      "slides": [
        {
          "slide_index": 1,
          "file": "renders/carousel-01-slide-01.png",
          "eyebrow": "INÍCIO 2027 · ÁFRICA DO SUL & GLOBAL",
          "headline": "3 Razões Pelas Quais Estudantes Ambiciosos Perdem Financiamento Todos os Anos",
          "subhead": "E como construir um Roteiro com prazos rastreados em 4 minutos →",
          "footer_note": "Deslize para a lista de verificação (1/5)"
        }
      ]
    },
    {
      "id": "static-feed-01",
      "type": "static_ad",
      "archetype": "comparação-nos-vs-eles",
      "format": "4:5",
      "width": 1080,
      "height": 1350,
      "file": "renders/static-feed-01.png",
      "eyebrow": "ORIENTAÇÃO UNIVERSITÁRIA & DE BOLSAS",
      "headline": "Pare de Adivinhar a Partir de 40 Abas de Navegador Abertas.",
      "subhead": "Obtenha 3 Correspondências Universitárias com uma Pontuação de Compatibilidade Transparente e um Roteiro Passo a Passo.",
      "primary_text": "A Gradwyn combina estudantes com universidades e bolsas usando IA—com razões claras e fontes oficiais.",
      "cta_label": "Obtenha Suas 3 Correspondências"
    }
  ]
}

Estágios 2 e 3 — Construir Artboards e Rasterizar para PNG

  1. Comece a partir de resources/ad-canvas-starter.html ou use o renderizador embutido dentro de scripts/qa_static_ads.py (--render-from-manifest) que pode renderizar artboards PNG nítidos e de qualidade de publicação em 1080×1350, 1080×1080, 1080×1920, 1200×628 e 1920×1080 diretamente de ads-manifest.json usando Pillow + fontes TrueType (NotoSerif / NotoSans) quando a renderização headless do navegador não estiver disponível.
  2. Respeite as zonas seguras da plataforma definidas em references/archetypes-and-safe-zones.md:
    • Anúncio de História/Reel 9:16 (1080×1920): Mantenha todo texto e logotipos dentro de y: 250px .. 1520px e x: 72px .. 1008px.
    • Feed/Carrossel 4:5 (1080×1350): Mantenha todo texto dentro do preenchimento externo de 72px (caixa segura 936×1206) e mantenha os selos indicadores de slide fora do canto superior direito de 140×100px onde o Instagram sobrepõe o contador 1/5.
    • Quadrado 1:1 (1080×1080): Preenchimento externo de 64px.

Estágio 4 — Verificação de Qualidade Visual e de Copy Determinística

Execute o motor de QA na pasta da campanha:

python3 scripts/qa_static_ads.py --manifest outputs/<campaign-slug>/ads-manifest.json --render-missing

O que qa_static_ads.py verifica em cada ativo:

  • Integridade de Arquivo e Pixel: Cada PNG referenciado existe, não está corrompido e corresponde exatamente à sua largura e altura de pixel declaradas (1080×1350, 1080×1080, 1080×1920, 1200×628, 1920×1080).
  • Verificação de Variância Visual e Margem de Borda: Confirma que a imagem não está em branco/plana e verifica as bordas da zona segura para recorte acidental de texto.
  • Densidade e Hierarquia de Copy: Aplica limites de palavras/caracteres de título (<= 12 palavras no título no canvas para leitura instantânea em mobile), completeza do texto principal e presença de CTA.
  • Gate de Diretriz e Claim Proibida: Verifica cada título, subtítulo, corpo do slide e legenda principal contra banned_phrases de MASTER_CONTEXT.md. Qualquer violação reprova o QA com um relatório de linha exata.
  • Inspeção Visual: Após qa_static_ads.py passar, inspecione visualmente os PNGs renderizados para confirmar hierarquia, contraste e alinhamento.

Estágio 5 — Quadro de Revisão Visual Interativo

Gere o canvas de revisão humana:

python3 scripts/build_ad_review_board.py --manifest outputs/<campaign-slug>/ads-manifest.json

Isso escreve outputs/<campaign-slug>/review/index.html com:

  • Pré-visualização horizontal com deslize/rolagem de cada Carrossel do Instagram em ordem de slides.
  • Grade completa de Anúncios de Imagem Estática, Anúncios de História, Banners e Miniaturas.
  • Alternância de Sobreposição de Zona Segura Interativa (mostra zonas mortas da UI do Meta/IG/TikTok diretamente sobre os gráficos).
  • Selos de QA por Ativo (Aprovado / Aviso / Reprovado de _qa/qa-report.json).
  • Cópia com Um Clique para Texto Principal, Título e URLs de CTA com UTMs.
  • Alternâncias de Aprovar / Sinalizar para Revisão com exportação de notas de revisão em JSON.

Habilidades Relacionadas