feat(integrations): add skills endpoint, enrich creative context with client info, and support meta in creatives

This commit is contained in:
Marcos Fargas
2026-10-12 18:40:11 +02:00
parent 52cebab3e6
commit a7e2723a3e
7 changed files with 359 additions and 3 deletions

View File

@@ -0,0 +1,65 @@
# Skill de formato · Estático para Meta Ads (4:5)
> Se aplica junto a la skill del cliente. Define la estructura de un anuncio estático de imagen para feed de Instagram y Facebook. Siempre 4:5 (1080×1350).
## Qué entregas por cada variante
Un objeto JSON con exactamente estos campos:
```json
{
"angle": "nombre corto del ángulo (p. ej. 'objeción tiempo', 'prueba social', 'coste FUNDAE', 'antes/después', 'autoridad')",
"hook": "titular que va EN la imagen, máx. 8 palabras",
"support": "línea de apoyo en la imagen, máx. 12 palabras, opcional (null si no hace falta)",
"headline": "título del anuncio en Meta, máx. 40 caracteres",
"primary_text": "texto principal del anuncio, 2-4 frases, máx. 300 caracteres, la primera frase es el gancho",
"cta": "uno de: 'Más información', 'Solicitar presupuesto', 'Reservar', 'Contactar', 'Registrarte'",
"image_prompt": "prompt en inglés para el generador de imagen, SIN texto ni logo, describiendo escena, personas, luz, encuadre y paleta",
"layout": "una de: 'foto-con-franja' (foto + franja de color con titular), 'tipografico' (solo color y texto), 'dato-grande' (una cifra enorme + contexto)",
"rationale": "una frase: por qué este ángulo puede relevar a la fatigada"
}
```
## Reglas de ángulo
- Cada variante ataca un **ángulo distinto** entre sí y distinto del de la creatividad fatigada (viene en `avoid_angles`).
- Prioriza ángulos que aún no se hayan probado en el cliente (mira `top_creatives` del contexto: lo que ya funciona no se repite, se complementa).
- Rotación recomendada: dolor → solución → prueba → objeción → oferta. Si la fatigada era "oferta", el relevo vuelve a "dolor" o "prueba".
## Reglas de hook (titular en imagen)
- Máximo 8 palabras. Si necesita más, no es un hook.
- Una sola idea. Un verbo o un dato.
- Sin signos de exclamación. Sin mayúsculas completas.
- Se lee en 1,5 segundos en móvil con el pulgar en movimiento.
- Prohibido empezar por "¿Sabías que", "Descubre", "Imagina".
## Reglas de copy (primary_text)
- Frase 1: repite o amplía el hook, nunca lo contradice.
- Frase 2-3: un beneficio concreto o un dato.
- Frase final: el CTA en palabras, coherente con el botón.
- Sin hashtags. Sin enlaces en el texto.
## Reglas de imagen (image_prompt)
- Siempre en inglés, 40-80 palabras.
- Describe: sujeto, acción, entorno, luz, encuadre (vertical 4:5, espacio libre arriba o abajo para texto), paleta en términos de la skill del cliente.
- Termina siempre con: `no text, no logos, no watermarks, photorealistic, vertical 4:5 composition with clear negative space for a headline`.
- Nunca pidas personas reconocibles, marcas de terceros, ni niños.
- Una generación por variante. No pidas variaciones.
## Reglas de layout
- Zona segura: 8 % de margen en todos los lados. Texto nunca en el 15 % superior ni inferior (lo tapan la interfaz y el CTA de Meta).
- Jerarquía: hook ≥ 2× el tamaño del support.
- Contraste mínimo 4,5:1 entre texto y fondo.
- El logo ocupa como máximo el 12 % del ancho.
## Autocheck antes de entregar
- [ ] ¿Las variantes tienen ángulos distintos entre sí y del `avoid_angles`?
- [ ] ¿Cada hook tiene ≤ 8 palabras?
- [ ] ¿El primary_text cabe en 300 caracteres?
- [ ] ¿El image_prompt no pide texto ni logo?
- [ ] ¿Se respeta la lista de prohibiciones de la skill del cliente?