CommunityImagengithub.com

static-ad-design-agent

Convierte un kit de marca (colores, fuentes, logotipo, capturas de pantalla o MASTER_CONTEXT.md) junto con una oferta o ángulo en carruseles de Instagram terminados (1080x1350 / 1080x1080), anuncios estáticos para redes sociales (1080x1080, 1080x1350, 1080x1920, 1200x628), banners y miniaturas de video (1920x1080), completos con verificación determinista de calidad visual y de copia, y un panel de revisión HTML interactivo. Paquete complementario de mrpaidsocial-video-editor-agent. Úsalo siempre que el usuario solicite diseñar anuncios estáticos, carruseles de Instagram/LinkedIn, paquetes creativos para redes sociales pagadas, banners publicitarios o miniaturas a partir de una oferta o ángulo.

¿Qué es static-ad-design-agent?

El Static Ad Design Agent es una habilidad especializada para agentes de IA que convierte un kit de marca—definido a través de un archivo MASTER_CONTEXT.md, URL del sitio web, paleta de colores, fuentes, logotipo o capturas de pantalla del producto—junto con una oferta o ángulo de marketing en activos visuales listos para producción. Produce carruseles de Instagram de 5 a 7 diapositivas en formato 4:5 (1080x1350), un trío de anuncios estáticos (4:5, 1:1, 9:16), banners (1200x628) y miniaturas de video (1920x1080). La habilidad sigue un pipeline riguroso de cinco etapas: (0) ingesta del kit de marca y creación de tokens, (1) planificación del ángulo y arquetipo que genera un archivo ads-manifest.json, (2 y 3) construcción de mesas de trabajo y rasterizado a PNG, (4) un bucle de control de calidad determinista que verifica integridad de píxeles, zonas seguras, densidad de copia y frases prohibidas, y (5) un panel de revisión visual interactivo para aprobación humana. Está diseñada para plataformas como Claude Code, Cursor, Codex y otras herramientas de ingeniería asistida por IA. Su valor principal radica en automatizar la garantía de calidad visual y de copia, reemplazando las verificaciones manuales con asserts deterministas, e integrando la revisión humana a través de un panel HTML interactivo. Es el complemento estático del mrpaidsocial-video-editor-agent, y sigue la misma filosofía de 'verificar píxeles, zonas seguras y cumplimiento de afirmaciones—no intenciones'.

Compatible con~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 Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Agente de Diseño de Anuncios Estáticos y Gráficos (static-ad-design-agent)

Entrada: Kit de marca (MASTER_CONTEXT.md, URL del sitio web, paleta, fuentes, logotipo o capturas de pantalla del producto) + oferta/ángulo
Salida: Carruseles de Instagram, Anuncios de Imagen Estáticos (Feed, Retrato, Historia, Horizontal), Banners, Miniaturas, Control de Calidad Visual y de Copia Determinista (_qa/qa-report.json) y un Panel de Revisión Visual Interactivo (review/index.html).

Esta habilidad es el paquete complementario estático de mrpaidsocial-video-editor-agent. Sigue la misma cultura: verificar píxeles, zonas seguras y cumplimiento de afirmaciones—no intenciones.


El Pipeline de un Vistazo

(0) Ingesta y Tokens de Marca (MASTER_CONTEXT.md + oferta/ángulo)
        │
        ▼
(1) Plan de Ángulo y Arquetipo ──→ ads-manifest.json (variantes, carruseles, copia, UTMs)
        │
        ▼
(2) Construcción de Mesas de Trabajo ───────→ Mesas de trabajo HTML/CSS o Pillow/SVG a partir de ad-canvas-starter.html
        │
        ▼
(3) Rasterizar a PNG ────────→ 1080x1350 (4:5), 1080x1080 (1:1), 1080x1920 (9:16), 1200x628, 1920x1080
        │
        ▼
(4) Bucle de QA Determinista ───→ python3 scripts/qa_static_ads.py (píxeles, zonas seguras, afirmaciones prohibidas)
        │
        ▼
(5) Panel de Revisión Interactivo → python3 scripts/build_ad_review_board.py → review/index.html

Etapa 0 — Ingesta y Tokens de Marca

  1. Verifica si existe MASTER_CONTEXT.md en la raíz del espacio de trabajo actual (o cópialo desde MASTER_CONTEXT.template.md).
  2. Extrae:
    • Tokens de marca: --bg-ink, --bg-paper, --accent-primary, --accent-secondary, --accent-alert, fuentes de título/cuerpo, logotipo y capturas de pantalla reales del producto.
    • Guardarraíles: banned_phrases y reglas de vocabulario canónico.
  3. Confirma o establece por defecto el paquete de entregables:
    • Paquete de Carrusel: 5–7 diapositivas a 1080×1350 (4:5, máximo espacio vertical del feed).
    • Trío de Anuncios Estáticos: 1080×1350 (4:5 Feed), 1080×1080 (1:1 Cuadrado), 1080×1920 (9:16 Historia/Reel).
    • Banner / Miniatura: 1200×628 (Anuncio de Enlace/Display) o 1920×1080 (Miniatura de Video).
  4. Crea la carpeta de trabajo de la campaña:
    outputs/<slug-de-campaña>/
    ├── ads-manifest.json
    ├── artboards/
    ├── renders/
    ├── _qa/
    └── review/
    

Etapa 1 — Plan de Ángulo y Arquetipo (ads-manifest.json)

Lee references/archetypes-and-safe-zones.md antes de diseñar las tarjetas. Elige entre los 10 arquetipos probados de estáticos y carruseles:

  1. Cazador de Mitos con Sello de Falso (Captura de pantalla/afirmación con sello claro de FALSO o MITO → tarjeta de verdad)
  2. Comparación Dividida Nosotros vs. Ellos (Tabla de contraste de 2 columnas: Forma Antigua vs. Forma de la Marca)
  3. Prueba de UI de Producto Anotada (Captura de pantalla real del producto o tarjeta con 3 píldoras ampliadas)
  4. Acumulación de Costo/Tiempo (Recibo apilado de costos/horas ocultos vs. 1 solución limpia)
  5. Diagrama de Mecanismo de 3 Pasos (Entrada → Motor → Resultado con insignias numeradas)
  6. Héroe de Estadística + Fuente Citada (Llamada masiva de métrica + tira de citas textuales en la parte inferior)
  7. Tarjeta de Lista de Verificación ("No postules/lances hasta que marques estas 4 casillas")
  8. Tarjeta de Estado Antes/Después (Estado abrumado/disperso → estado de hoja de ruta estructurada)
  9. Carrusel Narrativo de 5–7 Diapositivas (Diapositiva 1 Gancho → Diapositiva 2 Agitación/Datos → Diapositivas 3–5 Valor Accionable + Prueba de Producto → Diapositiva 6 Lista de Verificación Resumen → Diapositiva 7 CTA)
  10. Miniatura/Banner de Alto Contraste (Frase contundente de 3–5 palabras + sujeto focal/UI + insignia de contraste)

Escribe outputs/<slug-de-campaña>/ads-manifest.json cumpliendo con el esquema verificado por scripts/qa_static_ads.py:

{
  "campaign_slug": "sa-bursary-deadlines-q4",
  "brand_name": "Gradwyn",
  "offer_angle": "No te pierdas las fechas límite de becas de ingeniería y CS en Sudáfrica porque los requisitos están enterrados en 40 PDFs.",
  "cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
  "banned_phrases": [
    "admisión garantizada",
    "beca garantizada",
    "probabilidad de ingresar",
    "probabilidad de admisión"
  ],
  "brand_palette": ["#0c1a17", "#f6f1e8", "#1a6b5c", "#c4892a", "#c45c4a"],
  "creatives": [
    {
      "id": "carousel-01",
      "type": "carousel",
      "archetype": "carrusel-narrativo-5-diapositivas",
      "format": "4:5",
      "width": 1080,
      "height": 1350,
      "primary_text": "La mayoría de los estudiantes pierden becas no por sus calificaciones, sino porque las descubren 2 semanas después de que cerró la fecha límite.",
      "headline": "Descubre becas emparejadas con tu Perfil de Estudiante",
      "cta_label": "Más Información",
      "slides": [
        {
          "slide_index": 1,
          "file": "renders/carousel-01-slide-01.png",
          "eyebrow": "INTAKE 2027 · SUDÁFRICA Y GLOBAL",
          "headline": "3 Razones por las que Estudiantes Ambiciosos Pierden Financiamiento Cada Año",
          "subhead": "Y cómo construir una Hoja de Ruta con seguimiento de plazos en 4 minutos →",
          "footer_note": "Desliza para la lista de verificación (1/5)"
        }
      ]
    },
    {
      "id": "static-feed-01",
      "type": "static_ad",
      "archetype": "comparación-nosotros-vs-ellos",
      "format": "4:5",
      "width": 1080,
      "height": 1350,
      "file": "renders/static-feed-01.png",
      "eyebrow": "ORIENTACIÓN UNIVERSITARIA Y DE BECAS",
      "headline": "Deja de Adivinar con 40 Pestañas del Navegador Abiertas.",
      "subhead": "Obtén 3 Coincidencias Universitarias con un Puntaje de Ajuste Transparente y una Hoja de Ruta Paso a Paso.",
      "primary_text": "Gradwyn empareja estudiantes con universidades y becas usando IA—con razones claras y fuentes oficiales.",
      "cta_label": "Obtén tus 3 Coincidencias"
    }
  ]
}

Etapas 2 y 3 — Construir Mesas de Trabajo y Rasterizar a PNG

  1. Comienza desde resources/ad-canvas-starter.html o usa el renderizador integrado dentro de scripts/qa_static_ads.py (--render-from-manifest) que puede renderizar mesas de trabajo PNG nítidas de calidad de publicación en 1080×1350, 1080×1080, 1080×1920, 1200×628 y 1920×1080 directamente desde ads-manifest.json usando Pillow + fuentes TrueType (NotoSerif / NotoSans) cuando la renderización del navegador sin cabeza no está disponible.
  2. Respeta las zonas seguras de la plataforma definidas en references/archetypes-and-safe-zones.md:
    • 9:16 (1080×1920) Anuncio de Historia/Reel: Mantén todo el texto y logotipos dentro de y: 250px .. 1520px y x: 72px .. 1008px.
    • 4:5 (1080×1350) Feed / Carrusel: Mantén todo el texto dentro del relleno exterior de 72px (caja segura de 936×1206) y mantén las insignias indicadoras de diapositiva fuera de la esquina superior derecha de 140×100px donde Instagram superpone el contador 1/5.
    • 1:1 (1080×1080) Cuadrado: Relleno exterior de 64px.

Etapa 4 — Control de Calidad Visual y de Copia Determinista

Ejecuta el motor de QA en la carpeta de la campaña:

python3 scripts/qa_static_ads.py --manifest outputs/<slug-de-campaña>/ads-manifest.json --render-missing

Lo que qa_static_ads.py verifica en cada activo:

  • Integridad de Archivo y Píxeles: Cada PNG referenciado existe, no está corrupto y coincide con su ancho y alto de píxeles declarados exactos (1080×1350, 1080×1080, 1080×1920, 1200×628, 1920×1080).
  • Verificación de Variación Visual y Margen de Borde: Confirma que la imagen no está en blanco/plana y verifica los bordes de las zonas seguras para evitar recortes accidentales de texto.
  • Densidad y Jerarquía de Copia: Aplica límites de palabras/caracteres en titulares (<= 12 palabras en el titular en pantalla para escaneo móvil instantáneo), integridad del texto principal y presencia de CTA.
  • Guardarraíl y Verificación de Afirmaciones Prohibidas: Escanea cada titular, subtítulo, cuerpo de diapositiva y caption principal contra banned_phrases de MASTER_CONTEXT.md. Cualquier infracción falla la QA con un informe de línea exacta.
  • Inspección Visual: Después de que qa_static_ads.py pase, inspecciona visualmente los PNG renderizados para confirmar jerarquía, contraste y alineación.

Etapa 5 — Panel de Revisión Visual Interactivo

Genera el lienzo de revisión humana:

python3 scripts/build_ad_review_board.py --manifest outputs/<slug-de-campaña>/ads-manifest.json

Esto escribe outputs/<slug-de-campaña>/review/index.html con:

  • Vista previa de deslizamiento/desplazamiento horizontal de cada tira de diapositivas de Carrusel de Instagram en orden.
  • Cuadrícula completa de Anuncios de Imagen Estáticos, Anuncios de Historia, Banners y Miniaturas.
  • Interruptor de Superposición de Zona Segura Interactiva (muestra las zonas muertas de la UI de Meta/IG/TikTok directamente sobre los gráficos).
  • Insignia de QA por Activo (Aprobado / Advertencia / Fallo de _qa/qa-report.json).
  • Copia con un Solo Clic para Texto Principal, Titular y URLs de CTA con etiquetas UTM.
  • Interruptores de Aprobar / Marcar para Revisión con exportación JSON de notas de revisión.

Skills relacionados